F86 Class Schedule 


Tools 


Day l Day 2 Day 3 
| | | 
| OVERVIEW | ADVANCED MCS | FNP INTERNALS 
| | USAGE | 
Morning | | | 
| General Telecomm | tty_ | Programs and 
| Concepts PLL | Databases 
| MCS Parts | | 
| FNP Description | | 
| | | 
| | 
| McS | RING 0 MCS | MCS METERING 
| ADMINISTRATION | INTERNALS | AND DEBUGGING 
After- | | | 
noon | CMF | Programs and | Ring 0 MCS Meters 
| FNP Core Image | Databases | FNP Meters 
| Operator Commands | Multics-FNP | debug fnp 
| | Dialogue | Dump Analysis 
| | | 
| | | 


MCS Overview 


m What is MCS 
[| Multics Communications System 


] Software to transfer data to/from terminals or other devices connected via 
communications lines 


[| Sometimes called MCM: Multics Communications Manager 
| Design is generalized, table-driven 
] Especially good at supporting diverse asynchronous terminals 
| In this course most of the major MCS topics are covered 
{ Administration 
|] CMF, TTF, FNP images 
| Use 
] All Ring 0 interfaces to MCS functions 
[ Internals 
] Ring 0 and FNP 
| Metering and Debugging 
[ Ring 0 and FNP 


| There are certain topics within MCS or related to MCS that will not be 
covered in detail 


] Details of various protocols 
] HASP, X.25, etc. 
| Video System 


| I/O Daemon software 


fon 


FNPs other than 355/6670 families 


Yrs 
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mw Standard Communications Concepts 


Some communications concepts that are not necessarily specific to Multics need 
to be understood in order to understand MCS. 


] ASCII Character Set 
|] Multics was one of the first systems to use ASCII standard 
] Character sizes | 
] 128 7-bit characters defined by standard 
] Usually transmitted as 8-bit characters 
] 7 data bits plus 1 parity bit 
[| Stored in 9-bit bytes in Multics 


] 7 data bits plus 2 zero bits 


tandard Communications Concepts 
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7-bit Character 
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7-bit Character Plus Parity Bit 


7-bit Character Stored in 9-bit Byte 


ct 


N 


) 


st 


uy 


KO 


th 


oe 


OV 


re ee ee ee ee 


mere ewrewmwre wn enw wen wer ewe ee Vw we ew ew eww ew we ewe ewe ewer ewe ew ewe ew ew ew ewe ew ewe ew eke ewe ew ewe eC ewe ee ew ee 


] Control characters 


Some ASCII codes are non-printing and have special uses 


T 
! 


| Multiple names are sometimes confusing 


] X-OFF, DC3, Control-S, “S, \023 


] X-ON, DCi, Control-Q, “Q, \021 
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MCS Overview 


] ESC, Control-[, “[, \0Q33 

] LF, NL, Control-J, *J, \012 

| GR, Control-M, *“M, \015 

| BS, Control-H, “H, \010 

[| Formfeed, NP, Control-L, “L, \O14 
| PAD, DEL, Rubout, \177 


| NUL, Control-@, “@, Control-SP, “SP, \000 


] BREAK (QUIT) is not an ASCII character 


MCS Overview 


] BREAK is a line condition discussed later under RS232 
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Bin 


0000000 
0000001 
0000010 
0000011 
0000100 
0000101 
0000110 
0000111 
0001000 
0001001 
0001010 
0001011 
0001100 
0001101 
0001110 
0001111 
0010000 
0010001 
0010010 
0010011 
0010100 
0010101 
0010110 
0010111 
0011000 
0011001 
0011010 
0011011 
0011100 
0011101 
0011110 
0011111 
0100000 
0100001 
0100010 
0100011 
0100100 
0100101 
0100110 
0100111 
0101000 
0101001 
0101010 
0101011 
0101100 
0101101 
0101110 
0101111 
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Dec Hex 
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ASCII Character Set Chart 
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Key /Name 


Control-@ 
Control-A 
Control-B 
Control-C 
Control-D 
Control-E 
Control-F 
Control -G 
Control-H 
Control-I 
Control-J 
Control-K 
Control-L 
Control-M 
Control-N 
Control-O 
Control-P 
Control-Q 
Control-R 
Control-S 
Control-T 
Control-U 
ControLl-V 
Control-W 
Control-X 
Gontrol-Y 
Control-Z 


ESC, Control - [ 


Control-\ 
Control - | 
Control -* 
Control-_ 
blank 


Other Definitions 


Control-SP on some terminals 
SOH, Start of Header 

STX, Start of Text 

ETX, End of Text 

EOT, End of Transmission 
ENQ, Enquiry 

ACK, Acknowledge 

Bell 

Backspace 

Horizontal Tab 

Newline, Line Feed, LF 
Vertical Tab 

New Page, Form Feed, FF 
Carriage Return 

Red Ribbon Shift, SO, Shift Out 
Black Ribbon Shift,SI, Shift In 
DLE, Data Link Escape 

DC1, X-ON 

DC2 

DC3, X-OFF 

DC4 

NAK, Negative Acknowledge 
SYN, Synchronous Idle 

ETB, End of Transmission Block 
CAN, Cancel 

EM, End of Medium 

SUB 

Escape, Alt-mode 

FS, File Separator 

GS, Group Separator 

RS, Record Separator 

US, Unit Separator 

Space 


exclamation point 


double quote 
number sign 
dollar sign 


percent 
ampersand 


acute accent 
left parenthesis 


right parenthesis 


asterisk 
plus 
comma 
minus 
period 


right slash 
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0110000 060 48 30 90 0 

0110001 061 49 31 #1 1 

0110010 062 50 32 2 2 

0110011 063 51 33 3 | 

0110100 064 52 34 4 4 

0110101 065 53 35 5 5 

0110110 066 54 36 6 6 

0110111 067 55 37 #7 7 

0111000 070 56 38 8 8 

0111001 O71 57 39 9 9 

0111010 072 58 3A : colon 
0111011 073 59 3B : semicolon 
0111100 074 60 3¢ < less than 
0111101 075 61 3D = equals 
0111110 076 62 3E > greater than 
0111111 077 63 3F ? question mark 
1000000 100 64 40 @ commercial at 
1000001 101 65 41 A Capital A 
1000010 102 66 42 B Capital B 
1000011 103 67 43 GC Capital C 
1000100 104 68 44 OD Capital D 
1000101 105 69 45 &£ Capital E 
1000110 106 70 46 F Capital F 
1000111 107 71 47 #G Capital G 
1001000 110 72 48 4H Capital H 
1001001 111 #73 49 TI Capital I 
1001010 112 74 4A J Capital J 
1001011 113 75 4B kK Capital K 
1001100 114 #76 4¢ L Capital L 
1001101 115 77 4D M Capital M 
1001110 116 78 4E WN Capital N 
1001111 117 ##=79 4F oO Capital 0 
1010000 120 80 50 P Capital P 
1010001 121 81 51 Q Capital Q 
1010010 122 82 52 R Capital R 
1010011 123 83 53 #«S§ Capital § 
1010100 124 84 54 T Capital T 
1010101 125 85 55 U Capital U 
1010110 126 86 56 V Capital V 
1010111 127 #87 57 W Capital W 
1011000 130 88 58 xX Capital X 
1011001 131 89 59 Y¥ Capital Y 
1011010 132 90 5A Z Capital Z 
1011011 133 91 SB [ left bracket 
1011100 134 92 5¢ \ back slash 
1011101 135 93 5D ] right bracket 
1011110 136 94 SE ~*~ circumflex 
1011111 #137 95 SF _ underline 
1100000 140 96 60 ' grave accent 
1100001 141 97 61 a small a 
1100010 142 98 62 »b small b 
1100011 143 99 63 e¢ small c 
1100100 144 100 64 4d small d 
1100101 145 101 65 e small e 
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1100110 
1100111 
1101000 
1101001 
1101010 
1101011 
1101100 
1101101 
1101110 
LIOLTIt 
1110000 
1110001 
1110010 
1110011 
1110100 
1110101 
1110110 
1110111 
1111000 
1111001 
1111010 
1111011 
1111100 
1111101 
fi is 8 
1111111 


146 
147 
150 
151 
152 
153 
154 
155 
156 
157 
160 
161 
162 
163 
164 
165 
166 
167 
170 
171 
172 
173 
174 
175 
176 
se 
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102 
103 
104 
105 
106 
107 
108 
109 
LLO 
iii 
112 
113 
114 
pe Bs: 
116 
Ae, 
118 
119 
120 
121 
122 
123 
124 
125 
126 
£27 
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PAD 


small 
small 
small 
small 
small 
small 
small 
small 
smail 
small 
small 
small 
small 
small 
small 
small 
small 
small 
small 
small 
small 
left brace 

vertical bar 

right brace 

tilde 

DEL Rubout 
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] Baud Rate 


|] Discrete signal events transmitted per second 


] New 2400 bps modems are 1200 baud 
] Line protocol 
[| Parameters of a line that user can’t change 
|] Parameters that user can change are called terminal protocol 
| A line can have several levels of protocols that: 
| Synchronise data transmission and reception 


|] Ensure correct and complete reception of data by flow control 
and acknowlegement of received data. 


| Multiplex data for different devices on single line 
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Communications Protocols Supported by Multics 


SERIAL BINARY 


| | / 
| | Synchronisation 
ASYNCHRONOUS SYNCHRONOUS | of Clocks 
| j {| and Data 


| | ‘ 


| | | | | ij 

| | | | | | Reliability 
KERMIT XMODEM BISYNC HDLC G115 | of data (flow 
| | 
| | 
| | 
| 
| 
| 


| control & 
| | acknowledge) 
| 


| / 
3270 HASP 2780 3780 X.25 RCI VIP POLLED | Multiplexing 


ee Ee Je. Gus a | 
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Us 


9 


J] Asynchronous Protocols 


] Data comes in bit by bit as changing signal on a wire with one 
voltage to represent logic 0 and another to represent logic 1 


] Two things need to be synchronized between the sender and the 
receiver: 


] When to sample each bit (synchronising clocks) 
] Which bit is the first in data (first in each character) 
] Asynchronous protocols resynchronize both for each character 
|] Start bit used to signal beginning of first bit of character 
|] Transition from idle state (logic 1) to start bit (logic 0) 


[ One or two stop bits used to put line in idle state at end of 
each character 


] 10 bits used to send 1 character, so BPS = 10 CPS, efficiency 
70% 
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Asynchronous Protocol 


Problem: Synchronisation of clocks and of data start | 


"6" = 066 octal = 0110110 binary = 00110110 with even parity 


At 300 baud, 1/300 sends between bits. 


Bits sent to send ASCII "6" 


----> Message Flow ----> 
| P | D6 | DS | D4 | DB | D2 | D1 { DO | 
0 0 1 ds 0 A. 1 0 
| | | | 
| | | | 
| | | | 
| | | | | | | | 
Pf Pt} tt tyoit rttoijiid 
[ete | sae | ects mie) Serer 
| 300}; 300] 300] 300] 300] 300] 300] 
| | | | | | | 
P D6 D5 D4 D3 D2 D1 DO 
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Asnynchronous Protocol 


Bits sent to send ASCII "6" 


----> Message Flow ----> 
Idle |Stop]| P | Dé | D5 | D4 | D3 [ D2 | DL | DO [Strt| Idle 
0 0 1 1 0 1 i 0 


aw coe eo 2ocee ooze wo Oo  oewo oow = wee © © @ eo 


See 
Transition 
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Asynchronous throughput 


LTILT1TOOLLOIOLLILOOLODLILAOLIAVGOILL 
IISPDDDDDDDSSPDDODODODODODSII 
ddtaaaaaaaattaaaaaaaatadd 
de. Oe ee ee ea ere Se Bet. Ele aS 
eepiaaaaaaarpiaaaaaaaree 
t t t t 
y. Bs 
1 parity bit 
1 start bit 
1 stop bit 
7 data bits 3 overhead bits 


Maximum throughput: 70% 
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In Multics, maximum speed for asynchronous lines is 19,200 bps 
Protocol used by typical asynchronous terminals is called ASCII 
] Could be used by non-ASCII, e.g. EBCDIC, terminals 
Multics used to support other asynchronous protocols 
] 2741 
[ 1050 
] ARDS 
Standard asynchronous connections provide no guarantee of reliability 


The Kermit and XMODEM protocols sit on top of the asynchronous 
protecol 


| They provide flow control, error detection, acknowledgement, for 
the purposes of reliable file transfer 


| Synchronous Protocols 


I 
I 
I 


Again, need to synchronize clocks and data 

Clocks are synchronized by extra signal 

Data synchronization is per-block 

Two or more SYNCcharacters are sent to indicate start of block 


Typical synchronous protocol adds information at beginning and end of 
each block 


[| Block length, checksum, etc. 


Typical synchronous protocol requires acknowledgement of each block 
from receiver 


Throughput depends on details of protocol, but is higher than 
asynchronous for medium to high volumes of data 
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Typical Synchronous Protocol 


[eS pase A eee | DP Dae es Di? DP Tesct 
he | OX f Deve. PAs Pp Aetes-2 A{A|R...R I 
Idle i ae ee ee: a (ee To) TP a. cA | Idle 
sata ettate | | | LoAe | Bs eas A | Al I...1 [e<++ss--2--- 
Lo 6t ce [| [L...L | 
i ot | L | | | E...E | 
a 4 ; | |} | R...R | 
<-Syne-> <-Hdr-> <------ Data----- > <-Trl-> 
Typical 
Values: 2 2 100 2 
2 Syne bytes 
2 Header bytes 
2 Trailer bytes 
100 data bytes 8 Overhead bytes 


Throughput: 100/108 = 93% 
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Synth tons 
] In Multics, maximum speed for asynehroneous lines is 72 KB 


|] Multics supports a variety of synchronous protocols: 
1 BSC 
] HASP 
] 2780/3780 
[ 3270 
J] G115 
] VIP 
[ Polled VIP 
] HDLC 
] X.25 


| Multiplexer 


| There are many ways to have several logical connections over a single 
physical connection 


] This is known as a multiplexed line 


[| For some types of multiplexed lines MCS can perform the work of 
multiplexing/demultiplexing the logical connections 


| The idea of multiplexing is generalized in MCS to include an 
arbitrary number of levels of multiplexing 


] MCS considers the FNP to be a multiplexer because it has many 
channels connected to it and multiplexes all of that information over 
a single physical connection (the DIA) 

| Modem 

] MOdulator/DEModulator 

] Allows data to be transmitted over phone lines 

] Many different standards for modems 

] Modems may be full or half duplex 


|] Not to be confused with echoplex 


| RS232/V24 
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| Defines connection between 
] Data Terminal Equipment (DTE): Terminal or computer 
|] Data Circuit-terminating Equipment (DCE): Modems 
| Connection is by 25 pin connectors and cables 
{ Diagram shows the pins used by Multics in asynchronous connections 
|] Synchronous connection also uses pin 24 for timing (clock signal) 


] Used for all Multics protocols except HDLC 


Mls ClereRs 
eke = ere 
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so gee Bard 
2 ere Aes? 


pce 3 
RS -232/V24 Hie - Dare Te amina Caprl 
Phone 
DTE RS232 DCE lines DCE RS232 DTE 
eee pet fa I eee 
| } Vv | | Vv | eee | 
| Terminal |----- | Modem | | Modem J----- | Computer | 
ener =e eee eres 
CCITT 
Circuit 
Pin No. Name Nom Description Description 
af 101 GND TP Ground Terre de protection 
y 102 GND TS Ground Terre de signalisation 
2 --> 103 TX ED Transmission Emission de donnees 
3 <-- 104 RX RD Reception Reception des donnees 
Trem rely > 105 RTS DPE Request to send’ Demande pour emettre 
holm 5 <.. 106 CTS PAE Clear to send Pret a emettre 
mele nn 6 <-- 107 DSR PDP Dataset ready Poste de donne pret 
ke 8 <-- 109 cD DP Carrier Detect Detection de la porteuse 


qeeen'20 --> 108 DTR CPD Data terminal ready Connectez le poste de donnees 


FEMALE 
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Modem Dialup Sequence 


TTY Modem =========== Modem FNP 

DTE DCE DCE DTE 
g (TX) 2 ------- > 2 2 <------- Z (TX) £ 
t (RX) 3 <------- 3 3 ------- S35 (RX) g 
c (RTS) Go ------- >4 4 <------- 4 (RTS) b 
e (CTS) 5 <------- 5 5 ------- > 5 (CTS) e 
d (DSR) 6 <------- 6 6 ------- > 6 (DSR) a 
e (cD) 8 <------- 8 8 ------- > 8 (CD) e 
c (DTR) 20 ------- > 20 20 <------- 20 (DTR) b 


To listen to a line, the FNP raises RTS (pin 4) and DTR (pin 20) 
and then waits for CTS (pin 5), DSR (pin 6) and CD (pin 8) to go 
high. 


The FNP detects a hangup if DSR (pin 6) or CD (pin 8) drop for more 
than one second. If CTS (pin 5) drops, the FNP suspends output. 


Scenario: 


a) Modem on FNP is powered on. falses DER 

b) FNP boots and listens to the line. ysaises R7G OR 

c) The terminal is turned on. feises o7¢ OTR 

d) The terminal’s modem is turned on. Asses DER 

e) The telephone call is made and the modems are connected. faSes (c7s CD) 
f) Multics sends the login banner. 


g) User types login line. 


Be Oe. 
Q ‘ Only chenges ee Coanec\von 
X 


rTS - halé d voles, PPaAMG NT mell oF feces yp 
DSR ~ Connec}\on | sTabl’shed 


CNG Fiow Contta( , tried Yo 


QTA on rer~, na | /rinur side 
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| Break/Interrupt 


I 


oe] 


Out-of-band signal 


] Line Driver 


] Also known as short-haul modems or point-to-point modems 


] Inexpensive replacement for modems for point-to-point connections 


] No real standards 


] Direct Connect 


| For very short distances, a direct RS232 connection is possible 


| Very inexpensive replacement for modems 


[| Theoretically limited to about 50’ 


|] Practically can be extended much further 


[ Known as hardwired connection, null modem, modem bypass 


] Each DTE must be made to think it is connected to a DCE 
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6-WIRE DIRECT CONNECT 


TTY FNP 

DTE DTE 
(PG) 1 Rescceeeeseseoess 1 
(SG) 7 wee renee eee eee 2 
(TX) 2 ------- \ [ereeeee 2 
(RX) 3 s-ce--- rm ------- 3 
(RTS) 4 --| [-- 4 
(CTS) 5 a a 5 
(DSR) 6 --| |-- 6 
(cD) 8 2a) eee pac le 8 
(DTR) 7A al aN --2---- 20 


Try FNP 

DTE DTE 
(PG) i 1 
(SG) 7 ----------------- | 
(TX) 2 ------- Ne 2 
(RX) a ater aS woeeee- 3 
(RTS) 4 --| |-- 4 
(CTS) 5 e = 5 
(DSR) 6. xe, Sai 
(CD) 8 eee i 8 
(DTR) 20 ------- a 20 
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Direct-Connect Dialup Sequence 


TTY 
DTE 
d (TX) Deen see a eee 
ec (RX) SF. cceanee ne eb rete 
b (RTS) 4 --| je 
b (CTS) 5 es ee 
a (DSR) Bat, ie 
a (CD) 8 ee pane 
b  (DTR) 20 =se---- Px eee 


Scenario: 


a) FNP boots and listens to the Line. 
b) The terminal is turned on. 

c) Multics sends the login banner. 

d) User types login line. 


(TX) 
(RX) 
(RTS) 
(CTS) 
(DSR) 
(CD) 


(DTR) 


4-WIRE DIRECT CONNECT 


TTY FNP 

DTE DTE 
(PG) 1 et 
(SG) 7 w2-- eee ee ----- ee 7 
(TX) 2 ------- \ freeneee 2 
(RX) 3 2-2-0 a etal 3 
(RTS) 4 --| [-- 4 
(CTS) 5 - 2 5 
(DSR) 6 = |-- 6 
(cD) 8 4) ee 8 
(DTR) 20 ------- ie 20 
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] ae Monitor 

[ Monitor RS232 signals and display transmitted and received data 
] Breakout Box 

| Monitor RS232 signals 

[| Also known as a Blue Box. 


Line Monitors, Blue Boxes 


Phone 
DTE RS232 DCE lines DCE RS232 DTE 
| | | 

| [ove af | V | } vi | | 
| Terminal |-+ +-}| Modem [=== | Modem |-+ +-| Computer | 
| 1 tdi | | f | ft | | 

re | an 

| Blue Box/| | Blue Box/| 

| Line Mon. | | Line Mon. | 

| | 


errr n2nwrzre een eee wwe ee eww www ewe www newer wwe eweweewe ew ee we ewe ew ew ew we ee ew ew ww ew oe ww we we wo 
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w Standard Multics Concepts 


] Ring O Supervisor 


Three ways to enter supervisor code: 
y P 
] Call 
] Explicit request for supervisor services 


] For example, create a segment, make a segment known, write 
data to a terminal, read input from a terminal, etc. 


[| Fault 

[| Faults are caused by conditions within the CPU 

] Implicit request for supervisor services 

| For example, page faults, segment faults, linkage faults 
[| Interrupt 

] Interrupts are caused by conditions outside the CFU 

|] Perform a service for another process 


| For example, handle completion of a disk read, interrupt 
from FNP, etc. 


] Initializer/Answering Service 
| The Initializer process has a number of tasks to perform 
] Listen to login lines 
|] Execute operator commands 
] Load FNPs, other multiplexers 
] Etc. 
[| Block/Wakeup 
| Mechanism used to wait for events of unknown duration 
] Terminal I/0, tape I/O 


] Process is in user ring while blocked 
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] When event occurs, some other process sends a wakeup to blocked 
process 


|] Compare with Wait/Notify, to wait for events of short duration 
[| Disk I/0, system locks 
] Process is in ring 0 while waiting 


|] When event occurs, some other process notifies waiting process 
by changing its Traffic Control state 
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a MCS Parts 


] FNP 
| Ring 0 


| Ring 4 


MCS Parts 
MCS Overview F86 Page 1-26 


Central 
System (CS) 


Multics 


Host 


Direct 
Interface 
Adapter 


220 


Communica- 
tion lines 


Communica- 
tion 
Devices 
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MCS Parts 


I/O Modules, e.g. tty_ 


Block/Wakeup 


PL/I: >sll, >sss 


Answering Service 
FNP loading, dumping 


PL/I: >tools 


Data conversion, translation 


Manage wired buffer space TTY-AuF 
Communicate with FNP 
Handle FNP interrupts 


De-multiplexing 
PL/I & ALM: Hardcore (MST) 


\JorFkece ada Per 


Transfer of data over DIA 


Buffer space management 


Echoing 


Padding Se. 


On other Systems 


dine on Fue, 7 Shootd 6 


Dita Vaaster 


indertvAll, 


+. 


_ 


5 as foils Fal delays , ie = Ring © on MmyT 


Flow control fer ASyNc Xon “ord 


Tell 


CS state of channels 


Send terminal 


eee ee 


input to CS 


he SF Ad 


Send output from CS to terminal 


Modem control (RS-232, e.g.) 


Interval timers 

Format, interpret synchronous msgs 

MAP355: loaded from Multics into FNP 
A asvem Bly ] angrage 


MCS Parts 


F86 Page 1-27 


| The Ring 0 and FNP parts of MCS are covered in this course 


| The MCS functions made available to the user by Ring O and the FNP 
will be explained using the tty_ I/O module as an example 


[| Following diagram shows the relationships of the various 1/0 modules 
for terminal I/0 


] tty_ uses the same hcs_ interface as other I/O modules, and therefore 
makes a good example 


I/O Module Dependencies 


+----- hasp_workstation_ <--------------- + 

| | 

+----- hasp_host_ <---------------------- + 

| | 

+----- ibm3270_ | remote_input_ 

| +--ibm2780_/3780_ <--+---- remote _punch_ 
Poe ee bisyne_ <----+ | remote teleprinter_ 

hes_ <---+ ee re + remote _printer_ 

+----- gl15 <--------------------------- + 

| | 

+----- tty_ <------ tao eo ee eee eee - eee + 

| | 

+----- tce_io +----- kermit 

| | 
+----- emacs +----- xmodem_io_ 


Trees— Wes dereevy ASTRA oF wolde 


4040 Cher S ysTer~ 
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w FNP Hardware Description 
] Up to 8 FNPs can be configured 
] Names 
[ FNP 
|] Front-End Network Processor 
| Front End 
| Fuh-Nup 
] Datanet 
] DN355 
] 355 
| 6670 
| 6678 
] 18x 
| FEP 
| MPX 
] Model Numbers 
fr355 
| The original Multics FNP 
] Has given its name to many of the MCS programs 
] Limited to 32K memory 
] No longer supported as of MRI11 
] 6632 
| A newer version of the 355 
[| Limited to 32K memory 
| No longer supported as of MRI1 
[| 6670 


| Level-6 based, emulates 355 
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] Up to 256K memory with extended memory addressing 


| Two models 


] 6651 without cache 
| Architecture 
] Has same basic architecture as Multics: IOM, SCU+MEM, CPU 


] Peripherals connected to IOM 


| DIA 
] HSLAs 
FNP Architecture 
$---- 2-2 2-2 -- ee e- -eeee- + 
Multics | FNP | 

| | 

+------- + +------- + +o-c-e-- + | +----- + +----- + +----- + | 

| CPU +----- + SCU +----- + [TOM +----- DIA------ + IOM +--+ SCU +--+ CPU | | 

| | [Poa ress | | | [ | { [te--+] | | 

| || MEM || | | | | | ||MEMjj | 4 

| | [Resets +] | | | | Fe ae | | | 

+------- + +------- + torre ee + | +ete-+-+ +----- + +----- + | 
| i aaa 7 | 
| t-t----+ +--+---4+ | 
| | HSLA | | HSLA | | 

FNP IOM Channels: | etetett +-+-+-++ | 
pu ope pepe - - + -+-4---------- + 

0 FNP Console | | | | 

1 FNP Reader } | | Bip af 

2 FNP printer 

3 Terminals 

4 DIA 

5 € fila Dia 

6 HSLA 0 

7 HSLA 1 

8 HSLA 2 

9-14 LSLAs O9So'e<® 

15 Clock 


~—se ew eewenwwecvweoeen we scee wee sce eon ec eo eww ew wom e eco om eww Oe ew Bee ew De Owe Oe ee 
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] Data and Instruction Formats 
[ 18-bit words 


] I/O commands also know about 36-bit words 
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STORE REFERENCE INSTRUCTION FORMAT 


Delta 


9 


INDEX REGISTER (Xn) -- UNPAGED ADDRESS 


15 


1 
7 
| 
| 
| 


INDEX REGISTER (Xn) -- PAGED ADDRESS 


<a ee 
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| 
TAG|Page No. | 
| 


Offset 


8 


1 
z 
| 
| 
| 
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ACCUMULATOR REGISTER (A) 


0 if 

OE ane he 

| | 

| A 

| 
18 

QUOTIENT REGISTER (Q) 

0 1 

ee ern 

| | 

| Q | 

ee a ee ee eee 
18 


ACCUMULATOR-QUOTIENT REGISTER (AQ) 
0 As 3 
0 7s 

| | 

| Even Word (A) | Odd Word (Q) | 
| 


18 18 
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| Extended Memory Addressing 


] So-called paging is used to address beyond 32K 


TD 
1“ 


, 
extended memory 


| No programs in extended memory 
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Dhls v8 vesly how oF 


(5 Done 
FNP Extended Memory Addressing 

Memory 
+------------------------------ + 
| | 
+------------ >+ 000000 -000377 | 
| | Page 0 | 
| Hann nc ccc cen cc ccc n ec cee ence en-- au 
| | | 
| +---------- >+ 000400-000777 | 
| | | Page 1 | 
| | peo eer crt tee eee tee eee eee eee ees + 
[ | | | 
| | +-------- >+ 001000-001377 | 
Page Table } | | | Page 2 | 
+------ + i | | +------------------- +--+ ----- + 
4000 | A=0+-------------- ae | 6] | | 
tocseeet | | | | 
4001 | A=0+---------------- + | | | 
teoec oot | i | 
4002 | A=0+------------------ + Hann nn er re rn re eens ee + 
too eenot | | 
| ae | +------------ >+ 076400-076777 | 
| nl | | Page 175 | 
t------ + | +------------------- +--+ ------- + 
4175 | A=0+-------------- + | | 
+------ + | 077000-077377 | 
4176 | A=1+------------ + | Page 176 | 
+------ + | an ww ee ee ee ee en ee ee ee eee + 
4177 | A=1+-------------- + | { 
+------ + Hi, 3 | 077400-077777 | 
| | | Page 177, end of 32K | 
| | PGiweee eSeecestocesceeeesese + 
| | | | 
| | | 100000-100377 | 
| | Page 200, start extended mem | 
| | +------------------------------ + 
| | | | 
| +------------ >+ 100400-100777 | 
| | Page 201 | 
| +------------------------------ + 
| | | 
| | | 
| | | 
| | | 
| | | 
ta we ce re er re tr rr err terre + 
| | | 
+-------------- >+ 177000-177377 | 
| Page 376 | 
+------------------------------ + 
| | 
| 177400-177777 
| Page 377, end of 64K | 
fo 2-2 - eee ---------------- + 
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FNP Address Calculation Example 1 
Reference To Address In Low-Order Memory Using Non-Paged Addressing 
ce (x2)=076700; c(x3)=077240; c(475)=004000; ¢(4175)=000000; c¢(4176)=133040 
Be 


Ny oyives addi 
ar £o5 8 Yale 


nos ee wtwosescemeraxscocwmoenmr se BD eB Dewees eeoaenwca 


| 
| | | | | 
| O | 10 | 000111 | 000000001 
| | | 
| oO | | o7 | 001 ~ | 


le + eee + 
Ne \ / | Final Address | 
| | le oe + 
| 1 9 | 7 | 6 | 7 | O fF 2 | 
Vv oo + 
jistedecurecee te cdeeee ean dese aces + l 
| X-register 2 | | 
Pe Seu cress ec Sones ol eee sae. + l 
PO fe pe BP 208 | 
| | | | | | | 
| 000 | 111 {| 110 { 111 | 000 | 000 j | 
Ce eee ee ee in eee + l 
| Tag | 15-bit address | | 
i | -------- 2222-222 ee eee 
j; oO | 76700 | 
+---------------- 2 ---- ee eee ee -ee + 
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FNP Address Calculation Example 1 
Reference To Address In Low-Order Memory Using Paged Addressing 


ce (x2)=076700; ¢(x3)=077240; ¢(475)=004000; ¢(4175)=000000; ¢(4176)=133040 


too rennenn er eeeeeee------- + 
| Instruction: lda 1,2 | 
$-- 2-2-2 eo eee ee ee eee + 
i ae ae as Ce 
| 010 | 000 | 111 | 000 | 000 | OO1 | 
fo ---- 22 ee eee eee -- + 
| I |Tag | Opcode | Delta | 
i We ek | 
| O | 10 { OOO111 | 000000001 | 
Liggett | | 
fo |, -2 4 07 | 001 H 

+----- 2-2-2222 eee + -- + H- 2-2 - ee oe ee ee eee + 

Ne \ / | Final Address | 

| | Faw we cc new enter nee c cece nee tne ern ee- + 

| Oe Ce oe Pee She | AO de af 

$----------------------------------- + 
$----- 22-22-22 ee e+ --- + 
| X-register 2 | 
+----------------------------------- + 


oon eee ere e+ -- 2 ee -- = ----- + 
| Tag | 15-bit address | 
Lod | ----~-+ 2222-22-22 -2- 
| 76700 | 
fo -- 2-2 e- 2+ +--+ -- +--+ +--+ -------- + 
| Tag | Page No. | Offset | 
| | | | 
| 000 | 1111101 #J| 4121 000 000 | 
| | | | 
| O | 75 | 300 | 
po --- 2-2-2 ------ 2-2 + - +--+ ----- + 

\ / 

| 

V 
$----------------------------------- + 
| Page table entry @ 4175 
| [c(475) + 175 -> 4176] | 
Poceee Sess ese see eee Se kos eee + 
ie ee i ee a Os 


| Page addr mod 256] [Act | | 


| | 
| 000 000 000 O | 00 | O | 00000 | 
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FNP Address Calculation Example 3 
Reference To Address In Extended Memory 


ce (x2)=076700; c¢(x3)=077240; ¢c(475)=004000; ¢(4175)=000000; c¢(4176)=133040 


oo + 
| Instruction: lda 1,3 | 
Soe + 
| 3 | 9 | 7 | O09 | O9 | tf | 
| | 
{| O1L | 000 | 111 | 000 | 000 | 001 | 
pone ce ec ee ee en ne ee nner e nen ee + 
| I j{Tag | Opceode | Delta | 
ee | | | | 
| re | i ' ' 
|} O | 11 | 000111 | 000000001 | 
| | | | | 
|} Oo}; 3 | 07 | 001 | 
es + he one eee ee ee ee eee ee ee ee ee eee + 
\ / \ / | Final Address 
| | te 22 - eee ee ee ee ee ee eee ee ee + 
Pt} 3 |] 3 | 2 | 4 J] 2 | 
lee + +--- - - oe ee ee ee ee eee eee ee + 
| X-register 3 | | 
tee ee ee ee ee ee ee ee ee -- + | 
} O | F | 7 | 2 | 4 | D8 | | 
| | | | | 
| OOO {| 111 | 111 | 010 | 100 | 000 | | 
edo ween Sie Slaw fee tetrad we eal ees + l 
| Tag | 15-bit address | | 
| | | | 
{| oO | 77240 | | 
Heo ne ee ne ee eee ee ee eee + He en eee ne ee ee ee eee eee eee + 
| Tag | Page No. | Offset | f lL | 3 | 3 | 2 | 4 | O | 
| | | | | | | | 
{| 000 | 111 1110 | 410 100 000 | } OO1 | O11 | O11 | 010 | 100 | 000 | 
; | | | et ewenannen onsen nnaesecenvwsinncds <> + 
} O | 176 | 240 | } 0O1 O11 O11 O | 10 100 000 | 
le er eee + t--- ee ne eee eee ee ee ee eee e+e ee + 
V7 VS / 
Vv ne Sere A 
H---- ee ee ee ee ee ee =e + | 
| Page table entry @ 4176 } | 
| [c(475) + 176 -> 4176] | | 
5 oe + | 
| tt 3 | 3 | 9 | 4 | O f I 
| | | | | | | | 
} OOL | O11 | O11 | OOO | 100 | 000 | | 
5 ee eo + | 
| Page addr mod 256] jAct| } | 
| | mt | | 
j OOL O11 O11 O | 0O | 1 {| COOOO | | 
eee + | 
--2--- \ ferteeee | 
| 
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[| HSLA 
] High-Speed Line Adapter 
] Emulated in 6670s 
] All communications lines are connected to HSLAs 
|] Maximum of 32 channels per HSLA 
|] Maximum of 3 HSLAs per FNP => maximum of 96 channels per FNP 


| HSLAs do much of the work of running a channel, freeing up the FNP’s 
GPU 


] Set and detect RS232 signals 
|] Interrupt FNP when a signal changes 
| Read incoming characters into a buffer 
|] Interrupt FNP when action is required 
[| Buffer full 
| BREAK condition 
[| Interesting character (such as CR, LF, EOT) read 


] Character Control Table (CCT) tells HSLA what characters 
are interesting 


] Does not do echoing 
| Send buffer of characters to terminal 
] Interrupt FNP when finished 
] Old FNPs had HSLAs and LSLAs (Low-Speed Line Adapters) 
| Channel names 
[| One component for each level of multiplexing 
] FNP. H/L 99 
] b.hALOL 
| FNP . H/L 99 . SUB 
[| a.h006.prtl 


| Mother/Daughter Boards 
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| HSLAs are emulated by Mother and Daughter Boards 
| Communications lines are connected to daughter boards 


P Ee gee aen ao — ~ a aan 
j Two lines are connected to each 


] There are different types of daughter boards for different types 
of lines 


] Asynchronous 
| Autocall channels rodems oh Boneh ‘Yo Cat oat 


BSC 


Comey 


] G115 
] HDLC X26 Concedrions only | channet( Per board 
] HDLC daughter boards only have oe ey ney two 
|] Daughter boards are properly known as CLAs | 
| Communications Line Adapter 
] Daughter boards are mounted on mother boards 
| Four daughter boards can be mounted on one mother board 
] Maximum combined speed of lines on mother board is 72KB 
] An FNP can have up to 16 mother boards 
[ 12 mother boards 4 daughter boards 2 lines => 96 lines per FNP 
] 4 mother boards are the equivalent of an HSLA (32 lines) 


] Mother boards are properly known as HMLCs 


] High-speed multi-line controller 


LalesT aria t 6h maT ber bench \S 


~ locy ve. 
Rossi BY Col Klore , fel Conc! JS: Ve 
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[a.h231 a.h230] 
| CLA | 
| OA oytyret Bed 


[a.hl07 a.hl06| 
| CLA | 


[a.hO31 a.h030| 
| CLA | 
| 


Ja.hO23 a.h022| 
| CLA | 
| 


[a.hOl5 a.hOl4| 
| CLA | 
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Mother/Daughter Boards 


[a.h229 a.h228| 
| CLA | 


j}a.hl105 a.hl04| 
| CLA | 


}a.h029 a.h028| 
| CLA | 
| 


ja.hO21 a.h020| 
| CLA | 
| 


Ja.hO13 a.hOl2| 
| CLA | 


| 
CLA 
| 
HMLC 
o HMLC = Mother 
o CLA = 


ja.h227 a.h226| 
| CLA | 


Ja.h103 a.h102| 
| CLA | 


Ja.hO27 a.h026] 
| CLA | 


ja.hO19 a.h018} 
| CLA | 


|a.hO1l a.h010| 
| CLA | 


| 
| cla 
| | 


Board 


Daughter Board 


[a.h225 a.h224| 
| CLA | 


Ja.h101 a.h100} 
| CLA | 


Ja.hO25 a.h024| 
| CLA | 


[a.hO17 a.h016| 
| CLA | 
| 


[a.h009 a.h008| 
| CLA | 


| | 
| LA 
| | 
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| DIA 
] Direct Interface Adapter 


| TYAT 


Connects Muitics IOM to FNP I0M 


| 


] 200KBit/sec smart controller 
] DIA can: 
|] Send interrupts in both directions 


| Transfer data between memories of FNP and Multics at request of 
either 


] MCS does not use all these possibilities, i.e. FNP initiates all data 
transfers 


[| Can have 2 DIAs per FNP 


] But Multics will view each DIA as a separate FNP 
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w MCS Manuals 
: [] AN85: Communication System SDN 
] MCS Internals, both Ring 0 and FNP 
|] Theoretically unavailable: last update MR7.0 
] C75: Multics Administrators’ Manual--Communicacions 
] AG93: Multics Subroutines and Input/Output Modules 
[ AG91: Multics Programmer's Reference Guide 
| TIF described ta Appendix B 
] Input conversion rules explained in Chapter 3 
] AN87: Hardware and Software Formats PLM 
| Theoretically obsolete and unavailable 
[ Chapter 6 has FNP data formats 


[ DDO1l: DN355/6600 Macro Assembler Program 
FvVe\ 


ae ~, 
CCA 


MCS Manuals = 
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= CMF/CDT 


I 
I 
I 
I 


Channel Definition Table 

CDT describes all configured FNPs, multiplexers, lines 

Created from ASCII source file Channel Master File 

An Answering Service Database 

Stored in >scl>cdt 

Used by Initializer to manage lines, logins, etc. 

Used to initialize Ring 0 databases at Multics bootload 
] Ring 0 Databases are not stored permanently 


Used to initialize FNP databases at FNP bootload 


CMF/CDT 
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Sample CMF 


Qray O “SLA lt Clonan 
Kn, AT ovy Ove 
Spare_channel count: 10; Allows you Yo odd Clannnells a 


FNP required time: 5; (F Cytdhes TeicQ tn : 
= q —SP_ =e N Oat ac aN ¢ ae Ly a ere | ke rer Doves Crash aor 
SVEAVES DSO “Vo \Gwer Lewy Wrol Vege ee, 
Check _acs: all; Ne. be Ne Ross. ay Be lower. . 
\wu tr, Waker C Cok +s LV Ke \ra wo wees WP 

FNP: a; nsqncle. VAR 

type: DN6670; 7 

We 0: ng VGA AS chet TE Lo weal 1T 

hsla: 3; 

memory : 64; 

image: >sldd>mcs>info>fnp_a; 

service: active; 
name: a.c000; comment: "COLTS executive channel"; 

baud: 9600; line_type: COLTS; terminal _type: none; 
service: slave; 
name: a.h00oo; comment: "console pupitre"; 

baud: 1200; line_type: ASCII; terminal_type: ROSY; 
service: mc; attributes: hardwired,dont_read_answerback; 
name: a. h0ol1; comment: “console datanet"; 

baud: 1200; line_type: ASCII; terminal_type: ROSY; 
service: login; attributes: hardwired,dont_read_answerback; 
name: a.h0co2; comment: “"AJ510 dans salle de consoles 125"; 
baud: 1200; line_type: ASCII; terminal _ type: AJ510; 
service: login; attributes: hardwired,dont_read_answerback; 
name : a.h003; comment: "AJ860 dans salle de consoles 121"; 
baud: 1200; line _ type: ASCII; terminal_type: AJ8&60; 
service: login; attributes: hardwired,dont_read_answerback; 


/*** a.n006 is X.25 Syne HDLC daughter. This board steals a.h007 as well. */ 


name: a.h006; 
comment: "X.25 canal principal 113001300"; 
service: multiplexer; 
multiplexer_type: x25; 
baud: 9600; 
terminal _ type: X25_TRANSPAC; 
line_type: X25LAP; 
name: a.h006.d01-a.h006.d02; 
service: autocall; 
generic destination: "transpac"; 
comment: "%.25 dial_out sub-channel"; 
name: a.h006.001-a.h006.013; 
service: login; 
comment: "%.25 login sub-channel"; 
terminal type: ascii _crt; 
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baud: 1200; 


attributes: dont_read_answerback; 
name: a.h008; comment: "connexion stations HASP"; 
baud: 4800; line_type: BSC; terminal type: HASP_HOST; 
multiplexer_type: hasp; 
service: multiplexer; attributes: “hardwired; 


name: a.h008.opr; 


service: slave; 
line_type: BSC; 
terminal type: HASP_HOST; 
name: a.h008.rdrl; 
service: slave; 
‘line_type: BSC; 
terminal type: HASP_ HOST; 
name: a.h008.prtl; 
service: slave; 
line type: BSC; 
terminal type: HASP_ HOST; 
name: a.h008.punl1; 
service: slave; 
line_type: BSC; 
terminal type: HASP_ HOST; 
name: a.h010; comment: "Questar dans le bureau Adjemian-Weber"; 
baud: 4800; line type: ASCII; terminal _type: VIP7205; 
service: login; attributes: hardwired,dont_read_answerback; 
CMF /CDT 
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J CMF delivered in >udd>sa>a 


| FNP_required_up time: 


] 2 crashes in this time => no reload 

| Applies to lower-level multiplexers as well 
|] Spare_channel_count: 

[| Global keyword 

| Number of extra entries in ring 0 databases 


| Adding CDT entries for which there is no room in ring 0 databases 
causes problems 


[| Other global keywords 
| Define default values for omitted local keywords 
] FNP: 
| One FNP statement for each configured FNP 
[| Followed by information about the FNP 
] type: 
[1 dn6670 oneric for Al! 
| memory: 
| Memory size in Kwords 
] hsla: 
|] Number of HSLAs: can always say 3 
[| Must have one line declared on HSLA 0 before using HSLA 1 
] Likewise for HSLA 1 and 2 
] image: 
|] Pathname of image to load in FNP 
] service: 


] active or inactive 
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[ name: 
] One name statement for each configured channel 
] Followed by information about the channel 
|] Can have a range of channel names, e.g. a.h006.001-a.h006.016 
| comment: 
| Comment stored in CDT 
] Not like /* comments */ which are ignored in CMF 
| Important to use comments to document 
[| Also important to have well-organized CMF 
| baud: GPS 
] Up to 19.2KB for async, 72KB for sync 


J] 110, 133, 140, 300, 600, 1200, 1800, 2400, 4800, 7200, 9600, 
19200, 40800, 50000, or 72000 


] line_type: 
Syne. Risyac 
] Line protocol: ASCII, G115, BSC, VIP, POLLED VIP, or X25LAP 
| Cannot be changed by user 
[ service: 
] login 
] Loaned to process for duration of process 
] Initializer owns all lines 
| slave 


[| Loaned to existing process, returned when finished or at 
end of process 


| Requested by sending wakeup to Initializer (using 
dial _manager_) 


| Example: Used by I/O daemons to attach printers, readers, 
low au? Cae: (oe ca wae: ~Thfs beh lee 


[ mc 


| Like slave, but for the Initializer’s own use 
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| Used for operator terminals 


[| autocall 


Lae al Sue ak TO Conrecd To nerwork ote oF Phone 7H 


] inactive 
] Not listened to when FNP boots 


| Useful for holding a spot for a line that is not yet 
physically installed 


] multiplexer 
| Line is a multiplexer channel 
| multiplexer_type statement must be used as well 
| multiplexer_type: 
] ibm3270, vip7760, hasp, x25, or sty 
| dataset_type: 
| Used mostly for half-duplex -modems 
[| Require special handling of RTS, CTS, etc. 
| terminal _type: 
| Can be changed dynamically by user 


] For multiplexer, TIF entry gives multiplexer-specific parameters 
in the additional_info field 


[| generic destination: 
| Valid for autocall and slave lines 
[| Allows users to attach line without knowing channel names 


] Useful to group together channels, allow changing channel 
assignments without affecting users 


| charge: 
[| Specifies a surcharge for using the channel 


] For login lines this is in addition to connect charges 
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|] Must correspond to device type in installation parms 
] check_acs: 
[ ACS Segments in >scl>rcep 
] E.g. >scl>rep>a.h00l.acs nuit Bccess %. Oyo Daemon 
| Keywords specify when access checking is to be done 
] login 
|] slave 
[| priv_attach 
[ dial_in 
[| dial_out 
J all 
| Default is priv_attach, dial_out 
|] attributes: 
|] hardwired 


| Eliminates use of the login time parameter in 
installation_parms 


] set_modes 
| Modes are set according to default terminal type at dialup 
[ Only attribute that is on by default 

| dont_read_answerback 


| System does not send “E (ENQ) at dialup to request 
terminal’s answerback 


|] check_answerback 

] See answerback statement 
[| audit 

[ See access_class statement 
[ none 


] “audit, *check_answerback,“dont_read_answerback, “hardwired 
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] Default is 
set_modes, “audit, “check_answerback, “dont_read_answerback, “hardwired 


[| answerback: 
| Specifies expected answerback for terminal 


] If check_answerback attribute is set, any other answerback will 
be refused connection 


| access_class: 
|] Specifies the AIM classes of users allowed to login on the line 
] Enforced if the audit attribute is set Ayestron ale 

| initial_command: 


| Preaccess command (e.g. login, modes, ttp, etc.) to be executed 
at each dialup 


| cv_cemf 
[ Converts CMF into CDT 
[| Usually CMF.cmf -> CMF.cdt 


| Resulting segment has same format as >scl>cdt but with no dynamic 
information 


] install 
| Initializer is the maintainer of CDT 
] Sends a request to Initializer 


|] Initializer merges dynamic info from existing CDT with info from new 
CDT 


|] Requires access to >scl>admin_acs>cdt.install.acs 
|] Adding, deleting, changing channels 
| Many CMF changes do not take affect immediately 
] Some require FNP reboot to take affect 
] Tables 5-1 and 5-2 in CC75 explain when changes take effect 
| Most important are adding lines and changing speed of lines 


] Require FNP reboot 
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| Two commands for displaying information from CDT 
| display_cdt 
] Gives detailed information on CDT entries 
| tty_lines 
| Gives brief information on CDT entries 


| reset_cdt_meters resets n_dialups, n_logins, dialed_up time ma fhe (en 


Peciag ict y 
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display_cdt 


CDTE at 515]15360 


in_use: 3 (dialed) 

name: a.hll4 

comment : DKU7102 sur sous canal mpx trt de Paris2 

charge type: 0 (none) 

service type: 1 (login) 

current_service_type: 1 (login) 

dim: 1 (tty) 

line_type: 1 (ASCII) 

terminal _type: DKU7102 

baud_rate: 1200 

fnp_no: 1 (a) 

flags.attributes: hardwired,dont_read_answerback,check_acs; 

event: 000470001164407777000107 

tra_vec: 3 (wait_login line) 

count: Bi 

tw: 46 

state: 5 (dialed up) 

current_terminal_type: AJ510 

cur_line_ type: 1 (ASCIT) 

tty_id_code: none 

process: 777771 

next_channel: 0 

n_dialups: 393 

n_logins: 348 

dialed _up_time: 1083 hrs 45 mins 11 secs. 

dialup time: 02/20/84 1727.4 hfh Mon 

recent_wakeup_count: J 

recent_wakeup_time: 02/20/84 1807.9 hfh Mon 
CMF/CDT 
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WO cn nA WS Whe 


(nm Ne Fe 


SNOW WMr OO 


Valu 
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es for tra_vec in display_cdt output 
and WP column in tty_lines output 


wait_dialup Channel waiting for dialup. 
wait_answerback WRU sent, waiting for reply 
wait_login line Greeting typed, wait for login command. 
wait_login args Want rest of login line 
wait_old_ password "-cpw" was specified. Wait for old password. 
wait_password Waiting for password. (If "-cpw", repeat of new one.) 
wait_new_password "-cpw" was specified. Wait for new password 
wait_logout_sig Channel is hooked up. Wait for logout. 
wait_logout A logout has been requested. Wait for process to die 
wait_logout_hold As above but don’t hang up when it dies. 
wait_detach As above but ignore channel afterwards. 
wait_new_proc As above but make new process and continue. 
wait_remove As above but completely expunge channel. 
wait_fin_priv_attach When channel dials up, connect it to user 
wait_dial_ release Waiting for master process to release. 
wait_dial_ out Waiting for auto call to complete 
wait_hangup Wait for the hangup event to occur for a channel 
wait_slave_ request Ignore line until someone asks 
wait_greeting msg Print greeting message and wait for login line 
wait_delete_ channel Channel deleted - mark cdte after process is destroyed 
wait_connect_request logged in; awaiting request re disconnected processes 
wait_tandd_hangup when channel hangs up, proceed with t & d attachment 
wait _fin_tandd_attach when channel dials up, finish t & d attachment 
wait_discard wakeups disregard all wakeups on channel 
wait_before hangup allow output to print before hanging up 
Values for state in display_cdt output 
and S column in tty_lines output 
masked Terminal channel is there, but masked by MCS 
hung Terminal channel is there, but dead. 
known Channel being "listened" to, awaiting dialup. 
dialed Channel is dialed up. This is normal state. 
Values for in_use in display_cdt output 
and A column in tty_lines output 
free Entry is empty. 
hung up Entry is usable but tty is hung up. 
listening Entry is waiting for phone call. 
dialed Entry is connected but login not complete. 
logged in Entry is logged in but no process. 
logged in & proc Entry has a valid process. 
dialing Entry (auto_call line) is dialing 
dialed out Entry (auto_call line) is in use 


CMF /CDT 
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tty_lines 


Attached lines = 132 (size = 136) at 02/20/84 1817.0 


Name Type No. S WP A Baud User 

a.c0Q00 (NU) 0 5 18 2 3600 COLTS executive channel 

a.h000 (NU) 05 QO 1 1200 console pupitre 

a.hoo1 ROSY 125 5 3 3 1200 console datanet 

a.hoo2 AJ510 171 5 6 3 1200 AJ510 dans salle de consoles 125 
a.h003 AJ860 155 5 17 1 1200 AJ860 dans salle de consoles 121 
a.h006 (NU) 00 01 1200 X.25 major channel 

a.h006.d01 1649 118 1 300 X.25 dial_out sub-channel 
a.h006.d02 603 1181 300 X.25 dial_out sub-channel 
a.h006.d03 228 118 1 300 X.25 dial_out sub-channel 
a.h006.d04 89 118 1 300 X.25 dial_out sub-channel 
a.h006.d05 38 118 1 300 X.25 dial_out sub-channel 
a.h006.001 ASCII_CAPS 2788 5 8 5 1200 Desgoutte CNIP2 (none) X.25 login sub-channel 
a.h006.002 MINITEL 1790 2 1 2 1200 X.25 login sub-channel 
a.h006.003 ASCII CRT 1441 2 1 2 1200 X.25 login sub-channel 
a.h006.004 ASCII_CRT 1144 2 1 2 1200 X.25 login sub-channel 
a.h006.005 ASCII_CRT 910 2 1 2 1200 X.25 login sub-channel 
a.h006.006 ASCII_CRT 719 2 1 2 1200 X.25 login sub-channel 
a.h006.007 ASCII CRT 587 2 1 2 1200 X.25 login sub-channel 


tty_lines display _cdt 
field field 
Name name : 
Type current_terminal_ type: 
No. n_dialups: 
S state: 
WP tra_vec: 
A in_use: 
Baud baud: 
User comment : 
CMF/CDT 
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gm FNP Images 


I 
I 


An FNP image is the software to load into the FNP 


It consists of ‘object decks’ of individual programs bound together by the 
bind_fnp command 


Two FNP images are delivered in system libraries 
] >unb>mcs 
T 


{| >unb>site_mcs 


When the FNP is booted (during Multics bootload or by operator command or 
after FNP crash) this software is sent to the FNP from Multics 


Before loading, configuration information from the CDT is patched in 


An FNP’s image must contain all software necessary to run the types of 
lines configured on the FNP 


An image should not have unneeded software 

| This would waste FNP memory that could be used for 1/0 buffers 
Choosing the necessary modules is the main work in creating an image 

J All software must fit in <32K 
The site_mcs and mcs images contain software for several types of lines 


Sites create their own FNP images tailored to their FNP line 
configurations 


Often have a different image for each FNP 


j Image is stored in a segment whose pathname is specified in CDT 


FNP Images 
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Module Name 


dia_man 
interpreter 
scheduler 
utilities 

init 

control tables 
hsla_man 


trace 
meters 
melt 


gll5_tables 
bsc_tables 
x25_tables 
hasp_tables 
vip_tables 
polled vip_tables 
ibm3270_ tables 
acu_tables 
autobaud tables 


ic_sampler 
breakpoint_man 
console man 


N 


ete oan 


mol t* Bekins 


at 


i QrocesS Can 


MCS Administration 


FNP MODULES 


Needed if: 


always 
line_type: ascii; 
hsla: >0; 


module: trace; 
meter: yes; 
line_type: COLTS 


Can Be Dice vA Ry im 


Which should happen: 


= lewnerm 


delay TSF SPAR Q00eE To Borrers 


ailen? on X25 Yea 
wm 


usually Slows ef ae 


usually 


usually Frees Paes 


line_type: gll5 sometimes (Level-6 remotes) 
line_type: bsc; sometimes (HASP, IBM remotes) 
line_type: x25lap; sometimes (real Multics x.25) 
multiplexer type: hasp sometimes (HASP) 
line_type: vip sometimes (Sync VIPs) 
line_type: polled vip. sometimes (Polled sync VIPs) 
line_type: bsc; + ibm3270_ sometimes (3270 controller) 
service: autocall; sometimes (non-x.25 dialout) 
baud: auto; sometimes 
debug fnp ic_sample rare 
debug fnp breakpoints rare 
console: yes; rare 
Corn Confeoler Cor 30'S. 

FNP Images 
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| The bind_fnp command uses a control file with .bind_fnp suffix to select 
software modules to put in FNP image 


FNP Images 
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/* bindfile for MCS, Multics Communications System */ 


version: 6.5d; 


lsla: 0; . 
sue a Co cKeS Pond “Oo Eat; O\herwise \oner peewee 
console: no; 
printer: no; 
meter: yes; 
/* module load list - init module must be last */ 
order: scheduler, 
interpreter, 
control _ tables, 
dia_man, 
melt, 
hsla_man, 
utilities, 
trace, 
bsc_tables, 
hasp_tables, 
x25 tables, 
meters, 
init; 
/* entry to init from bootload */ 
entry: istart; 
/* table size specifications */ 
module: hsla_ man; +! ic 
type: hsla; OS" 
size: 97; Greys 
module: trace; 
type: trace; 
mask: 317777; /* trace enable mask */ a 
size: 2048 ; 
/* mask bits: 0O scheduler 
1 dia_man 
2 interpreter 
3 utilities 
4 lsla_man 
5 hsla_man */ 


end; 


FNP Images 
MCS Administration 
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bind fnp 
fnp_a.bind_fnp [wd]>*.objdk 


| | 
| bind_fnp fnp_a | 


fnp_a.bind_fnp ([contents [wd]>fnp_a.search])>*.objdk 


| 
Bee ee oe 
| | 
| bind_fnp fnp_a -dr -list | 
es ee, eA ee 
| | 
Vv Vv 
fnp_a fnp_a.list 


FNP Images 
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LDD Structure 


re + 
ldd ! 
| de WHE | 
+------- +------ + 
| 
a +------ + 
| mcs | 
+------- +------ + 
| 
pence ence eee eee we eee ence n ene ee eee enee- + 
| | | 
| | | 
+------- +------ + +------- +eeee-- + +------- +------ + 
| source | | object | | info | 
+------- $eo----- + +o--2--- foece-- + +------- +------ + 
| | | 
| | | 
*.s.archive * archive 355_macros 
macros .map355 
macros asm 
site_mcs.bind_fnp 
site_mes.list 
mes .bind_fnp 
mes.list 
FNP Images 
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SLDD Structure 


+-------------- + 
| sldd | 
+------- o----- + 
t------- +------ + 
| mcs | 
+------- $------ + 
| 
+-------------------- foe 2-2 -- eee eee eee + 
| | | 
| | | 
+------- +------ + +------- +------ + +------- +------ + 
| source | | object I | info | 
+------- $------ + +------- +------ + +------- +------ + 
| | 
| | | 
*.s.ud.archive * .objdk fnp_a.bind_ fnp 
fnp_a.list 
fnp_a.search 
fnp_b.bind_fnp 
fnp_b.list 
fnp_b.search 
355 macros 
macros .map355 
FNP Images 
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] map355 


] The assembler for MAP355, the assembler language of the FNP 


—— es 


pomemd, 


] GCOS software is necessary 
] toto.map355 -> toto.objdk 
|] -list control argument 


] -macro_file control argument 


] Default is -macro file >ldd>mcs>info>355 macros 


] macros 


| Like include files for PL/I 


] gcos >ldd>mcs>info>macros_asm -truncate {-list -lower_case}. 


[| macros.map355 -> 355 macros 


FNP Images 
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w Attributes in SAT/PDT 
"at [ones 
| dialok Slave id 


] save_on_disconnect 


| disconnect_ok 


Attributes in SAT/PDT 
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m Config deck 
] PRPH FNP A A 18. ON 
] PARM TTYB 10240. 


] Default = 6K 


Config deck 
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s installation_parms 
] cwe_count 


|] Initializer hangs up login line if more than cwe_count wakeups in 
cwe_ time seconds 


] Default 10 
| cwe_time 
] Default 3 seconds 
] login _time 
| Initializer hangs up login line if no login in login time seconds 
[| Typical value 180 seconds 
] Not used for lines marked attibutes: hardwired 
| device prices, device names 


| Used in conjuction with charge type: in CDT 


installation_parms 
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m Operator commands 
|] load_mpx 
{| Start FNP or lower-level multiplexer 
[| Starting FNP means loading it with image 
] Then load lower-level multiplexers 


| And start listening to all non-multiplexed lines that are 
not service: inactive 


I Starting lower-level multiplexer is similar to listening to a 
non-multiplexed lines 


] Accept connection, and when connection is made initiate 
protocol 


[| Done automatically during Multics bootload (during Answering Service 
startup) and after multiplexer crash 


] Done manually with load_mpx to change some line attrs, add lines 
| Any lines already in use must be hung up before reloading multiplexer 
] Use -force to force hangups 
| dump_mpx 
] Stops multiplexer completely 
] If it is an FNP, a dump is taken 
| stop_mpx 
] Stops further dialups from being accepted by multiplexer 
] Used when an FNP with logged in users must be reloaded 
| stop_mpx 
|] send_message or warn or bump fnp 
] load_mpx 
| Prevents automatic loading if done before Answering Service startup 
| start_mpx 
[| Undoes the effect of stop _mpx 


| bump fnp tag 


Operator commands 
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| Allows bumping of users on a single FNP 
[| detach 

| Makes a line inactive, bumping any user connected on the line 
| remove 


] Like detach, but uses a more brutal method of terminating user’s 
process 


[| attach 
] Makes a line active, undoing the effect of detach or remove 
[ Can also recover masked channels 

| accept 
] Accepts the line as an operator terminal 


] Line must be service: mc, or can type ‘dial system’ on a login 
terminal 


| drop 


| Undoes the affect of an accept 


Operator commands 
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Advanced MCS User Features 


w Terminal Characteristics 

] Many terminal characteristics can be modified 
] Character set/code 
] Character sequences to move carriage/cursor 
] Use of tabs 
] Padding 
] Terminal initialization (set tabs, etc.) 
[| Line/page length 
] Character echoing modes 

| These characteristics can all be modified several different ways 
] TIF | 
[ stty 
] io_call control, io-call modes 
| iox_Scontrol, iox_$modes 


[| We will look at how to modify them in per terminal-type in TIF and 
dynamically using iox_ 


| stty and io call are just command-level interfaces to iox_ 


Terminal Characteristics 
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/ 


gw TTF/TIT 
[| ASCII source Terminal Type File is used to produce Terminal Type Table 
] Has three major types of information 
| Characteristics of different terminal types for use by Ring 0 and FNP 


[| Characteristics of different terminal types for use by the Video 
System 


{ Definition of some preaccess commands 
] Definition of ia aa 
| System TIT is in >sel>ttt \, y, Ls 
[eve 
] Converts TIF to TIT 
|] Usually TIF.ttf£ -> TTF.ttt 
] install 
| The install command is used to install new TTT in >scl>ttt 


| Unlike CMF, there is no dynamic information 


[| Process calling the install command does the installation itself 


Omen 


>scl>ttt is protected by ring brackets of 1,5,5 

| Access required to >scl>admin_acs>ttt.install.acs 
[| Can use private TTTs 

] set_ttt_path 
1 


{ Specifies the TTT to use in process 


| Preaccess command and answerbacks not meaningful in private TTT, 
since they are only handled by Initializer 


| display_ttt 
| Used to display some or all of a TIT 
] TTF Syntax 


] TIF is a typical source file for a table with statements identified 
by keywords 


ELE/TIE 
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| Many statements take characters or lists of characters as arguments 
| Such characters may be specified in several different ways 

| Single unquoted character, e.g. % 

| Single quoted character, e.g. "xX" or: "32 

] 1 to 3 digit octal number, e.g. 033 

[] Control character name, e.g. ESC 

| Control characters in form “A 
J] Repetition of single characters or groups of characters is possible 


[ Uses (N) for repetition factor 


[ < ... > to group characters 


TTF/TIT 
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Terminal Type Definition 
Input_conversion: standard _input_conv; 


[xex*x*x Typical ASCII teleprinter terminal *****/ 

terminal _ type: ASCII; 

modes: default,1179,*pl,can_type=overstrike,hndlquit, 
fulldpx,echoplex,crecho,1fecho, “tabs, tabecho; 


bauds: 110 133 150 300 600 1200 ; 
vert_nl_ delays: 0 a 1 5 9 18 bees 
horz_nl_ delays: 0.00 0.012 0.025 0.019 0.060 O20 85 5% 
const_tab_ delays: 0 0 0 0 2 3 Pe 
var_tab_ delays: 0 0.180 0.250 0.250 0.500 1.000 6 6.65 
backspace delays: 0 0 0 0 a 2 : 
vt_ff delays: 9 24 29 59 100 200 a 


output_conversion: ascii_output_conv; 
special: ascii_special; 

line types: ASCII, VIP, POLLED VIP; 
old_ type: 11; 


[/x*xk*x ASCII teleprinter terminal (upper-case only) *****/ 
terminal type: ASCII CAPS like ASCII; 
modes: default,1179,“pl,can_type=overstrike,hndlquit,capo, 
fulldpx,echoplex,crecho,1lfecho, “tabs, tabecho; 
special: ascii_caps_special; 
input_translation: ascii_caps_input_trans; 
old_ type: 7; 


[/x**kkX Typical ASCII crt terminal *****/ 

terminal type: ASCII CRT like ASCIT; 

modes: default,1179,p123,can_type=replace,hndlquit,scroll, 
fulldpx, echoplex,crecho,1fecho, “tabs, tabecho; 


avs fe Se Se ee 


bauds: 110 133 150 300 600 1200 we 

{***k* ASCII CRI terminal (upper-case only) *****/ 

terminal type: ASCII _CRT_ CAPS like ASCII_CAPS; 

modes: default,1179,p123,can_type=replace,hndlquit,scroll,capo, 
fulldpx,echoplex,crecho,lfecho, “tabs ,tabecho; 

bauds: 110 133 150 300 600 1200 


[/RE**k* TeleVideo, Inc. Model TVI-912 **%x**/ 
terminal type: TVI912 like ASCII_CRT; 
modes: default,1179,p123,can_type=replace,hndlquit,scroll, 
fulldpx,echoplex,crecho,1lfecho, tabs, “*tabecho; 
initial_string: ESC 3 CR ESC 1 (7) <(10) <SP> ESC 1> CR; 
special: tvi912_ tvi920 special; 


TIF/TIT 
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w tty_ Modes and Control Orders 


I 


i 


Look at many functions of Ring Zero and FNP by looking at user interface 


Loo) 
L0e 


ate TIN AGIs 
try 4/V moauLie 


= 2 ne ee eens 
Xalip Les 


Much processing is the same for non-multiplexed synchronous lines, and for 
subchannels of multiplexers 


Comparison with other line types is made whenever possible 


Terminal Initialization 


| 
I 
I 
I 
I 


Initial string specified in TIT 

Sent to terminal at dialup time 

Generally used to set tabs 

Can be resent using send_initial_string control order 


Only useful for asynchronous terminals 


| Input Conversion, Translation, etc. 


I 


All terminal input goes through four steps of conversion and 
translation 


| Translate to ASCII | - — cola \ ot 
| Put in canonical form Susect “Ya ere 
] Process erase and kill characters 
| Process input escape sequences 
All of these steps are performed in ring 0 
All of these steps are exactly the same for all line types: 


asynchronous lines, non-multiplexed synchronous lines, multiplexer 
subchannels 


2 ee ‘ AN a chasse WAS 
Translation \4¢°, ac.bic To Ast. Goma Py Ke¥> Ror does ne 
\S Prleod Ta KEN, 
J] Input is translated into ASCII 


] Similar to PL/I translate builtin 
[| Does not change size of input string 
J] Does not change what is echoed to terminal 


[| Echoing is done in FNP, translation is done later in Ring 0 


tty_ Modes and Control Orders 
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|] ctl_char mode 


] When a terminal is in ctl_char mode, control characters are 
accepted as input 


] Otherwise control characters are discarded 


] If terminal is not in ctl_char mode, a second translation 
is done to translate all control characters into NULs 


[ NULs are normally discarded later in the input 
translation/conversion process 


tty_ Modes and Control Orders 
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Input Translation 
Extract From Terminal Type File 


terminal type: 


input_translation: ascii_caps_input_trans; 


Teo 
gv Cher AU 
: Oey Coase 

translation_table: ascii_caps_input_trans; 

000 001 002 003 004 005 006 007 /*NUL SOH STX ETX EOT ENQ ACK BEL (000-007)*/ 
010 011 012 013 014 015 016 017 /*BS TAB LF VI FF CR SO SI _ (010-017)%*/ 
020 021 022 023 024 025 026 027 /*DLE DC1 DC2 DC3 DC4 NAK SYN ETB (020-027)*/ 
030 031 032 033 034 035 036 037 /*CAN EM SUB ESC FS GS RS US (030-037)*/ 
040 041 042 043 044 045 046 047 /*SP !| " # $ & & ' (040-047)*/ 
050 051 052 053 054 055 056 057 /*( ) * + = , - ~ f (050-057)*/ 
060 061 062 063 064 065 066 067 /*4O0 1 2 3 4 5 6 F_  (060-067)*/ 
070 O71 072 073 074 075 076 077 /*8 9  : 5 < = > ? (070-077)*/ 
100 141 142 143 144 145 146 147 /*@ A B CGC D E F G_— (100-107)*/ 
150 151 152 153 154 155 156 157 /*eH I J K L M N O-— (110-117)*/ 
160 161 162 163 164 165 166 167 /*P Q R S T U V W  (120-127)*/ 
170 171 172 133 134 135 136 137 /*X ¥Y¥ Z [ \ ] * _  (130-137)*/ 
140 141 142 143 144 145 146 147 /** ab ec de £ g- (140-147)*/ 
150 151 152 153 154 155 156 157 /*#h i j k 1 m on oo (150-157)*/ 
160 161 162 163 164 165 166 167 /*p qr s t uv wi  (160-167)*/ 
170 171 172 173 174 175 176 177;/*x y za { | } =~ DEL (170-177)*/ 


Extract from tty_convert.incl.pll 
Used for get_input_translation and set_input_translation control orders 


del CV_TRANS VERSION fixed bin int static options (constant) init (2); 
del 1 cv_trans_struc aligned based, 
2 version fixed bin, 

2 default fixed bin, 

2 cv_trans like cv_trans; 


del 1 cv_trans based aligned, 
2 value (0:255) fixed bin (8) unal; 


tty_ Modes and Control Orders 
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[| Canonicalization whet U See nbaT vu aol artroack 
] Backspaces present a particular problem on input 


] When we see the string abc in a file we can’t know if it was 
originally typed in 


| abc<BS><BS><BS> 
] a<BS>_b<BS>_c<BS>_ 


] Or even ab<BS>_<BS><BS>a<BS>___ <SP><BS><BS>c 


7 


Similarly if we see the line abc on a CRT screen it may have 
been typed an infinite number of different ways 


[| abd<BS>c, for example 


| Canonicalization tries to apply a what-you-see-is-what-you-get 
rule 


| There are two separate cases, for hardcopy terminals and CRTs 
] can_type=overstrike is for hardcopy terminals 


| If multiple characters are typed in the same column, the 
first characters are overstruck on paper 


] Input is canonicalized to be column by column 


[| Multiple characters in same column are put in sorted order, 
separated by backspaces 


oS ree eee SaVuw 


| In the example above, canonical form is <BS>a <BS>b <BS>c 
Pp a i = 
| can_type=replace is for screen terminals 


] If multiple characters are typed in the same column, the 
first characters are replaced on screen 


|] Input is canonicalized to be column by column 


] Only the last character in each column is retained, with no 
backspaces 


| Note that this dees not make BS the erase character 
| ab<SP><SP><BS>c and ab<SP><SP>#c give different results 
[| can mode 


| Turns canonicalization on or off 


tty_ Modes and Control Orders 
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] Erase and Kill Characters 
] # is normal erase character, @ is normal kill character 
{ Any other characters may be substituted 


J erkl mode 


|] Turns erase and kill processing on or off 


een wrerwrecrerwerenwewenenocowcmwrvoee eee nn ee ewowe wee we wT Pe we oc we wD OTP eoewmero@mworerwrrroe@ oo 


Erase and Kill Characters 
Extract From Terminal Type File 


Extract from tty_editing chars.incl.pll 
Used for get_editing chars and set_editing chars control orders 


del 1 editing chars aligned based (editing_chars_ptr), 
2 version fixed bin, 
2 erase char (1) unaligned, 
2 kill char (1) unaligned; 
del editing chars version_2 fixed bin internal static init (2); 
] Process input escape sequences 
| Each input character is looked up in input conversion table 
| Gets extra processing if marked 
| Break character 
] Used as end of line in get_line calls 


| White space removed in front of break character 


|] Doesn’t mean that the character will cause line to be 
read immediately 


|] Other modes determine when FNP sends line to Multics 


| Discard Qu Whe Pad (Lewes 


tty_ Modes and Control Orders 
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| Characters thrown away 
|] Formfeed 
] Discarded if page length > 0 
[| Dates from early days of EOP processing 
|] Escape 
] Not to be confused with ASCII ESC (033) 
] Usually backslash character 
| Changes interpretation of following character(s) 
I \<NL> \# \@ \007 \\ 


] Other escape sequences may be defined using input 
conversion table plus special table 


[ ese mode 


] Can be turned off to inhibit escape sequence processing 


haul (e--erec LAK ( 
Qroces& eScAGR Clar¢ 


tty_ Modes and Control Orders 
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Extract From Terminal Type File 


terminal _ type: 


Input Conversion 


input_conversion: standard_input_conv; 


conversion_table: standard_input_conv; 


00 00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
00 /* 
03; /* 


NUL 
BS 
DLE 


rg 


-H UI TPDoOnNnN 


a 


SOH 


5 
: 
2 4 


i) 
Oy Ww 


| eed 


“GO bh fe rerio tet oes SNe ee 


x 
x 


aa 
wr 


nN + sno 
m~RDRFAMmMNAK Ass WwW + H BF! 


NROONDaWwW-:- 


ti 


~” 


DC4 


—mrrar”"HroaA Fe 


ENQ ACK BEL 
CR sO 
NAK SYN 


6B Oe ON Ut ee 


RS 
& 


>a BAmyvVvoa- 


{<5 


SI 
ETB 
US 


ZOAanN~AIN »& 


Os oa! 


EL 


(000-007) 
(010-017) 
(020-027) 
(030-037) 
(040-047) 
(050-057) 
(060-067) 
(070-077) 
(100-107) 
(110-117) 
(120-127) 
(130-137) 
(140-147) 
(150-157) 
(160-167) 
(170-177) 


Extract from tty_convert.incl.pll 
Used for get_input_conversion and set_input_conversion control orders 


del 


del 1 
2 version fixed bin, 
2 default fixed bin, 
2 


del 1 


cv_trans like cv_trans; 


cv_trans based aligned, 


cv_trans_ struc aligned based, 


2 value (0:255) fixed bin (8) unal; 


del 


INPUT CONVERT BREAK init (1), 


INPUT CONVERT ESCAPE init (2), 
INPUT CONVERT DISCARD init (3), 


(INPUT_CONVERT_ORDINARY init (0), 


INPUT_CONVERT_FORMFEED init (4), 
INPUT_CONVERT_ PRECEDENCE DISCARD init (5) 
) fixed bin (8) unaligned internal static options (constant) ; 
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F86 


CV_TRANS VERSION fixed bin int static options (constant) init (2); 
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Special Characters Table 
(Only Parts Used In Input Conversion Are Shown Here) 
Extract From Terminal Type File 


terminal_type: 
special: ascii_caps special; 


special table: ascii_caps_special; 


ThanslaTes \a tnto A 


(most of table is used in output conversion) 


input_escapes: /* <escape> <lc-alpha> -> <uc-alpha> (eg: \a -> A) */ 
Walt mat ; mht a = j tot uct ; tqt up ; Uelt ae Aad ; 
wen up ; i A ngn ; nh "aA" : ee a ; | i ny" : 
he nen ; ny a : tm tt mMt , int nN j No" to" : 
“p" pe ‘ "q" SO" : nye "Re : Bgt aS" : eae ie be . 
may" ba Ou F Meztt nyn ; Nyt myn : Nyt nxn ; en myn ; tet uz : 


Extract from tty_convert.incl.pll 
(Only Parts Used In Input Conversion Are Shown Here) 
Used for get_special and set_special control orders 


del SPECIAL VERSION fixed bin int static options (constant) init (1); 


del 1 c_chars based aligned, 
2 count fixed bin (8) unaligned, 
2 chars (3) char (1) unaligned; 


del 1 special chars struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 special chars, 


(most of table is used in output conversion) 


3 escape length fixed bin, 


3 input_escapes aligned, 

4 len fixed bin (8) unaligned, 

4 str char (sc_input_escape_len refer 

(special chars _struc.input_escapes.len)) unaligned, 
3 input_results aligned, 

4 pad bit (9) unaligned, 

4 str char (sc_input_escape_ len refer 

(special chars _struc.input_escapes.len)) unaligned; 


del 1 get_special_info_struc based aligned, 
2 area_ptr pointer, 
2 table ptr pointer; 
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] All of the input translation and conversion steps can be bypassed 


| rawi mode ViPeQQ WorkKS Vast way 


| All terminal output goes through three steps of conversion and 
translation 


] Capitalization 
| Formatting 
| Translation from ASCII 
] All of these steps are performed in ring 0 
] All of these steps are exactly the same for all line types: 
asynchronous lines, non-multiplexed synchronous lines, multiplexer 
subchannels 
|] Capitalization 
[| capo mode 
: Conver . 
] If in capo mode, txanslate all alphabetics to uppercase 
Not ¥ TOY VWtaunSlatyor 
| Formatting 
] 11 mode 
] “11 or LINN, e.g. 1179 
] Insert <NL> after NN characters 
] pl mode 
] “pl or plNN, e.g. p123 
] Stop with End of Page string after NN lines 
] End of Page string specifiable in special table 
] Continue with CR or FF 
] CR thrown away if on line by itself 
] FF always thrown away if NN > 0 


] Originally only FF was accepted 


[| scroll mode 
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[] Used in conjunction with pl mode 

] scroll intended for scrolling terminals 
] EOP after NN lines of continuous output 
[| Line counter reset after user input 

|] “scroll intended for non-scrolling screens, e.g. TEK4014 
] Counter not reset, user input adds to counter 
| EOP after NN lines of input or output 

] edited mode 


] In “edited mode, non-printing characters are output as 
octal escapes are printed, e.g. \000 


] In edited mode, non-printing characters are discarded on 
output 
[ tabs mode Fe ble at low seeds 


] In tabs mode, white space is optimized into minimum number 
of tabs and blanks 


| Terminal’s tabs must have been set by initial string 
| red mode 


RS D tiaa AD wassnan 
ae 5 vr we a t=" Ny LauUuscyn 


] In red mode, SO (¢ r 
terminal to shift to color 


[ SI (\017 or BRS, produced by ioa_ *B) changes back to 
normal 


] Used in some system error messages 
|] Actually sends sequence from special table 
[ On old terminals, shifted to red ribbon 
] On CRTs, can change to-inverse video 
|] vertsp mode 
|] In vertsp mode, FF and VT are sent to terminal 
| Actually sends sequence from special table 


[| In “vertsp mode, FF and VI are sent as octal escapes 
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] Output Conversion 


] Output conversion uses the output_conversion and special 
tables 
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Output Conversion 
Extract From Terminal Type File 


terminal type: 
output_conversion: ascii _output_conv; 


conversion_table: ascii_output_conv; 

07 07 07 07 07 07 07 12 /* NUL SOH STX ETX EOT ENQ ACK BEL (000-007) */ 
04 03 O01 05 06 02 10 11 /* BS TAB LF VI FF CR SO SI (010-017) */ 
07 07 07 07 O07 07 07 O7 /* DLE DC1l DC2 DC3 DC4 NAK SYN ETB (020-027) */ 
07 07 O07 07 07 07 07 07 /* CAN EM SUB ESC FS GS RS US _ (030-037) */ 


00 00 00 00 00 00 00 00 /* SP | " # $ & & ' (040-047) */ 
00 00 00 00 00 0000 00 /* ( +) * + =, | / (050-057) */ 
00 00 00 00 00 0000 00 /*0 1 2 3 4 5 6 7 (060-067) */ 
00 00 00 00 00 0000 00 /* 8 9 : 3; < = > 2? (070-077) */ 
00 00 00 00 00 00 0000 /* @ A B C D E F G_~ (100-107) */ 
00 00 00 00 00 0000 00 /*K H I J K L M N O- (110-117) */ 
00 00 00 00 00 0000 00 /* P Q R S T U V W_~ (120-127) */ 
00 00 00 00 00 00 0000 /*X Y Z [ \ ] * _ (130-137) */ 
00 00 00 00 00 00 00 00 /* * a b ce de £ g (140-147) */ 
00 00 00 00 00 000000 /keh i fj k 1 m n 0 (150-157) ¥/ 
00 00 00 00 00 00 0000 /*k p q rr s t ui vw (160-167) */ 
00 00 00 00 00 00 00 14;/* x y z { | 3} ~ DEL (170-177) */ 
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Extract from tty_convert.inel.pll 
Used for get_output_conversion and set_output_conversion control orders 


del cCV_TRANS VERSION fixed bin int static options (constant) init (2); 
del 1 cv_trans_struc aligned based, 
version fixed bin, 


default fixed bin, 
ev_trans like cv_trans; 


oe 


del 1 cv_trans based aligned, 
2 value (0:255) fixed bin (8) unal; 


del (OUTPUT_CONVERT_ORDINARY init (0), 
OUTPUT CONVERT NEWLINE init (1), 
OUTPUT CONVERT CR init (2), 
OUTPUT CONVERT HT init (3), 
OUTPUT CONVERT BS init (4), 
OUTPUT CONVERT VT init (5), 
OUTPUT CONVERT FF init (6), 


OUTPUT CONVERT RRS init (8), 

OUTPUT_CONVERT_BRS init (9), 

OUTPUT CONVERT NO MOTION init (10), 

OUTPUT CONVERT PRECEDENCE NO MOTION init (11), 

OUTPUT CONVERT DONT SEND init (12), 
OUTPUT_CONVERT FIRST SPECIAL init (17) 

) fixed bin (8) unaligned internal static options (constant); 
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terminal_type: 
special: ascii_caps_special; 


special table: ascii_caps_ special; 


new_line: 


carriage return: 


backspace: 
tab: 

vertical tab: 
form_feed: 
printer_on: 
printer_off: 
red _ shift: 
black shift: 
end_of page: 


input_escapes: 


t qa" 
it £*" 
cil ke" 
It, ff 
P 


Mat 


wAn ; 
pea : 
nen ; 
npr , 
ny" ; 


Special Characters Table 


Extract From Terminal 


CR LF; 


CR; 
BS; 


TAB ; 


VT CR; 
FF CR; 


oP 


E O P; 


Type File 


ee masks 0% white el on Cds 
wpforiS yecat eC Bina 


/* <escape> <lc-alpha> -> <uc-alpha> (eg 


h i 


Ww gs" 


ny" 


tpt 
q 


Ttyytt 


oils . 
ng . 
Lt Pd ; 
rOP : 
myn ; 
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ton 
nh" 
mM" 
yt 
My 
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wees ; 
bes Ga : 
a : 
> dae 3 
wy : 


" dat 


ujn 
tint 


Hott 
Nyt 


mp" ; 
me . 
hr ; 
ngt 
ayn : 


i" e tt 
t 5 7 
~ 
wt re) if 
W t wt 
it ft 
» 


wet ; 
nye ; 
mor ; 
eT ‘ 
aye ; 


ge AR 3 
wodt LE Pe@rumat 


>: \a -> A) */ 


% rid % tt 
a Zo5 
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Extract from tty_convert.incl.pll 
Used for get_special and set_special control orders 


del SPECIAL VERSION fixed bin int static options (constant) init (1); 


del 1 c_chars based aligned, 
2 count fixed bin (8) unaligned, 
2 chars (3) char (1) unaligned; 


del 1 special _chars_ struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 

2 special chars, 
nl_seq aligned like c_chars, 
cr_seq aligned like c_chars, 
bs_seq aligned like c_chars, 
tab_seq aligned like c_chars, 
vt_seq aligned like c_chars, 
f£_seq aligned like c_chars, 
printer_on aligned like c_chars, 
printer_off aligned like c_chars, 
red_ribbon_shift aligned like c_chars, 
black_ribbon_shift aligned like c chars, 
end_of_ page aligned like c_chars, 
escape length fixed bin, 
not_edited_escapes (sc_escape len refer 
(special chars _struc.escape_length)) like c_chars, 
3 edited_escapes (sc_escape len refer 
(special _chars_struc.escape_length)) like c_chars, 
3 input_escapes aligned, 

4 len fixed bin (8) unaligned, 

4 str char (sc_input_escape_len refer 

(special _chars_struc.input_escapes.len)) unaligned, 
3 input_results aligned, 

4 pad bit (9) unaligned, 

4 str char (sc_input_escape len refer 

(special_chars_struc.input_escapes.len)) unaligned; 


WW WW WW WW Ww bo WwW WwW Wd 


del 1 get_special_info_struc based aligned, 
2 area_ptr pointer, 
2 table_ptr pointer; 
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] Translation 

] Translate from ASCII to terminal’s character set 
[ To bypass all of the above 

] rawo mode 

| worl BAS) am vs 
] All of the above output conversion/translation is doné in ring 0 
| Echoing 

] Echoing is done in the FNP 
] Echoing makes sense only for asynchronous terminals 


] Asynchronous terminals connected via X.25 are a special case 


] FNP cannot do echoing, because it does not know about logical 
channels (@> UG:,q dato Came Creer elich Votes nat 


|] Echoing could be done in Ring 0, but would be expensive 
| X.25 has parameters to tell PAD to do echoing 

] fulldpx mode 
[| Specifies that line can send and receive at same time 


] Echoing implies fulldpx 


] If *fulldpx, Multics will not send while receiving 
| echoplex mode 

] Each character sent by terminal is echoed back 

| No selection, translation, conversion, etc. possible. 
| lfecho mode 


| When CR is received, LF is sent to terminal and placed in input 
stream 


] NL (same as LF) is only true end-of-line character for 
Multics 


|] When in “lfecho mode, CRs will appear to be ignored 


| crecho mode 
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] When LF is received, CR is echoed 
] Not allowed for X.25 lines 


| There is no X.25 parameter to have PAD 


Qu 
© 
Q 


] tabecho mode 


] When tab is received, FNP sends back spaces to move 
carriage/cursor to next tab stop 


] Not allowed for X.25 lines 
I There is no X.25 parameter to have PAD do crecho 
[| Quit Handling 
[| There are a number of steps in handling break condition 
| Handled both in ring 0 and in FNP 3 f\.54 ceurseet) 


|] True break condition can only occur on asynchronous lines 


j] Synchronous protocols such as POLLED VIP, X.25 have ways to 
achieve similar effect 


| There are two separate controls on this handling 
] Quits are enabled or disabled by control orders 
[ quit_enable control order 
] quit_disable control order 
] hndlquit mode 
+f -qtits—enabled: 
] 1) FNP sends NL, if in hndlquit mode 
| 2) FNP flushes buffers, if in hndlquit mode 
[| 3) FNP tells Ring 0 
] 4) Ring 0 flushes buffers, if in hndlquit mode 
LF Ors Lanes 
| 5) Ring 0 wakes up user process, signalling "quit" condition 
[| 6) Ring 4 default quit handler prints "QUIT" 
| For an X.25 line, FNP cannot handle individual logical channel 


] 1) PAD/X.25 network flush buffers, if in hndlquit mode 
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jf Sdes Sa en em 
ee : on X25 “tT a 


wow KIG6 Sers An 3 


] 2) PAD/X.25 network tell FNP (via control packet) 


On | 3) FNP sends control packet to ring 0 
i aa 
Q Ko | 4) Ring 0 sends NL, if in hndlquit mode 
Bre 
seems \ . ] 5) Ring 0 flushes buffers, if in hndlquit mode 
Be Coe \F Quy enaAte 


] 6) Ring 0 wakes up user process, signalling "quit" condition 
] 7) Ring 4 default quit handler prints "QUIT" 
] Polite, Replay 

] Sending output while user is typing can be disruptive 

] Modes exist to make it less disruptive 

] Valid only for asynchronous lines and X.25 subchannels 

] Handled in FNP 

[ polite mode 


| If any output occurs while user is typing input line will hold 
output until user finishes input line 


| Timeout after 30 seconds 


| Some X.25 networks have parameter to have PAD handle this 


pement 


prefixnl mode 
| Interrupting output is prefixed with a newline 


| If input line interrupted because “polite, or 30 second 
timeout 


| Not possible for X.25 lines 
[| replay mode 
[ Replays interrupted input line 


] If input line interrupted because “polite, or 30 second 
timeout 


[| Not possible for X.25 lines 
| Non-line-oriented input 


| Normally the FNP buffers a line of input and then sends entire line 
to Multics 
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J] On the Multics (Ring 0) side, the user process is woken up whenever 
input is sent from FNP to Multics 


|] There are ways to change when the FNP forwards data and when a user 


ed hee er a] ve we bea 


] breakall mode 
] Causes FNP to forward each character to Multics 
J] User process woken up for each character 
| Necessary or useful for certain applications 
|] Input from devices that never send CR or LF 
] dial_out 
| Emacs and Video System 
| Comparatively expensive 
] Echo Negotiation wot Rogutnah 


| Echo negotiation is an optimization to make it less expensive 
for Emacs and Video System 


| Typical situation in Emacs/Video is entering text at end of line 


] For each normal character that user types, all that needs to be 
done is echo and store 


] This is almost what FNP does in echoplex mode 
| Additional information needed 
[ List of characters that require more than simple echo 


|] Number of columns remaining on the current line of the 
screen 


[ No documented user interface for echo negotiation 
| To use echo negotiation 
] set_echo break table control order 


[| Input is table of 128 bits in table, telling FNP what 
chars to stop echoing on 


] Then call hes $tty_read_echoed 


] Input: buffer_ptr, buffer _size, columns left 
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| Output: #characters returned, #characters echoed 
] For X.25 lines, cannot be handled in FNP, nor in PAD 
| Handled in Ring 0 
| wake_tbl mode 
|] Changes when user process is woken up 
[| Handled in Ring 0 
| Valid for all types of lines 
] Normally woken up for every input 
[ Sometimes ere to wake up less often 
|] Consider qedx input mode 


| qedx has almost nothing to do, and nothing to print, until a \ 
is read 


| wake_tbl specifies that wakeup should be sent only when 
specified characters are in input 


| Table must be set by control order before turning on wake_tbl 
mode 
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Wakeup Table 
Not settable in TIF 


Extract from set_wakeup table info.incl.pll 
Used for set_wakeup_table control order 


del swt_info_version_1 fixed bin static options (constant) init (1); 


del 1 swt_info aligned based (swt_infop), 
2 version fixed bin, 
2 new_table like wakeup table, 
2 old _ table like wakeup table; 


del wakeup_tablep ptr; 


dcl 1 wakeup_table aligned based (wakeup_tablep), 
2 wake_map (0:127) bit (1) unal, 
2 mbz bit (16) unal; 


2. © 2 2 


[| Padding 


I 
I 


Many hardcopy terminals handle normal characters at line speed 
But require more time for carriage movement 


Padding (i.e. delay) characters can be sent to allow time for 
carriage movement 


Padding is done with NUL characters, which terminal discards 
Padding can be done for CR/LF, Tabs, BS, FF 


Specified in number of delay characters, or number of delay 
characters per column 


Padding requirements are different at different speeds 


Determining padding requirements is usually a matter of guessing and 
experimenting 


Padding for output is done in Ring 0 
Padding for echoed characters is done in FNP 


Can be done for any type of line, but only makes sense for 
asynchronous lines and X.25 subchannels 
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|] For X.25 no padding will be done for echoed characters 
] Not a problem 
] But X.25 does not know speed of terminal, only of multiplexed line 


] This has bad effects for padding 
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Delays 
Extract From Terminal Type File 


terminal _ type: 


bauds: 110 133 150 300 600 1200 ; 
vert_nl_ delays: 0 1 a 5 9 18 mas 
horz_nl_ delays: 0.00 0.012 0.025 0.019 0.060 O.120 085 
const_tab_ delays: 0 0 0 0 2 3 oe 
var_tab_ delays: 0 0.180 0.250 0.250 0.500 1.000...; 
backspace_delays: 0 0 0 0 Z 2 ; 
vt_ff_ delays: 9 24 29 59 100 200 ; 


Extract from tty_convert.incl.pll 
Used for get delay and set_delay control orders 


del DELAY VERSION fixed bin int static options (constant) init (1); 


del 1 delay_struc aligned based, 
version fixed bin, 
default fixed bin, 
delay like delay; 


Ph ho bh 


del 1 delay based aligned, 
vert_nl fixed bin, 
horz_nl float bin, 
-const_tab fixed bin, 
var_tab float bin, 
backspace fixed bin, 


vt_ff fixed bin; 


NM NM Bh Mh br 
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[| Output Flow Control 
| Some terminals cannot accept output as fast as Multics can send it 
| For synchronous lines, this is handled by protocol 
| For asynchronous lines, several modes exist to solve the problem 
[| These solutions are not valid for X.25 
|] Flow control must be betecen PAD and terminal 
] No X.25 parameters for this problem 
[| All flow control for asynchronous lines is handled in FNP 
] oflow mode 
] Turns on either of the two types of output flow control 
[| ETB/ACK output flow control 


[ Suspend-Resume output flow control 
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eal ae ROT 


ETB-ACK Output Flow Control Protocol 


Characters 
Sender sent Meaning 


Multics: thisisETB Here’s a block of output for 
(Silence while Multics waits for OK to resume 


Terminal: ACK OK, I can take another block 
Multics: theoutETB Here's a block of output for 


(Silence while Multics waits for OK to resume 


Terminal: ACK OK, I can take another block 
Multics: putforETB Here's a block of output for 


(Silence while Multics waits for OK to resume 


Terminal: ACK OK, I can take another block 


-) 


of up to 256 characters. 
you. 


-) 


of up to 256 characters. 
you. 


-) 


of up to 256 characters. 
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Sender 


Multics: 
Multics: 
Multics: 
Multics: 
Multics: 
Multics: 
Terminal: 


Suspend/Resume Output Flow 


Character 
sent 


QB mH Be OF ct 


-OFF 


Meaning 


Here’s 
Here’s 
Here’s 
Here's 
Here’s 
Here’s 


a 
a 
a 
a 
a 
a 


character 
character 
character 
character 
character 
character 


for 
for 
for 
for 
for 
for 


Control Protocol 


you. 
you. 
you. 
you. 
you. 
you. 


Wait, I can’t handle any more for the moment. 


(Silence while Multics waits for OK to resume.) 


Terminal: 
Multics: 
Multics: 
Multics: 
Multics: 
Multics: 
Terminal: 
Multics: 


ON 


eo 
Cc 
h 
e 
fe) 
u 
X-OFF 
t 


OK, I can handle some more now. 


Here’s 
Here’s 
Here’s 
Here’s 
Here's 


a 


a 
a 
a 
a 


character 
character 
character 
character 
character 


for 
for 
for 
for 
for 


you. 
you. 
you. 
you. 
you. 


Wait, I can’t handle any more for the moment. 
Here’s a character for you. 


(Silence while Multics waits for OK to resume.) 


Terminal: 
Multics: 
Multics: 


X-ON 


P 
u 


OK, I can handle some more now. 
Here’s a character for you. 
Here’s a character for you. 
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Output Flow Control 
Extracts From Terminal Type File 


output_suspend: “°S; output_end_of block: ETX; 
output resume: a8 sutrnur acknowl edge: ACK; 


NF eh er fF Oe Gew 4esaw 69 ae we we 


buffer size: 296; 


Extract from flow_control_info.incl.pll 
Used for get_ofc_info and output_flow_control_chars control orders 


del 1 output_flow_control_info aligned based, 
2 flags unaligned, 
3 suspend_resume bit (1), 
3 block_acknowledge bit (1), 
3 mbz bit (16), 
2 buffer_size fixed bin (18) unsigned unaligned, 
2 suspend_or_etb_seq unaligned, 
3 count fixed bin (9) unsigned, 
3 chars char (3), 
2 resume_or_ack seq unaligned, 
3 count fixed bin (9) unsigned, 
3 chars char (3); 


CAS ha dente plow COS 


vve 
ENS: 3 
oye 
DIC ee Pe ed 
gv 7 on) . le 
clo C 
ro “9 “er 
: aa ag 
N 
Hold, a, 
of © 
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] Input Flow Control 
] Multics normally expects asynchronous lines to send data slowly 
] At typing speed 


| Some terminals and microcomputers can send input to Multics at line 
speed 


] Multics cannot always keep up 
] For synchronous lines, this is handled by protocol 
| For asynchronous lines, several modes exist to solve the problem 
] These solutions are not valid for X.25 
| Flow control must be between PAD and terminal 
] No X.25 parameters for this problem 
] All flow control for asynchronous lines is handled in FNP 
|] blk_xfer mode 
|] For some terminals that send a screenful of data 
| Data must be bracketed by special characters 


] If read with a get_chars operation, whole screenful is returned 


— 
(©) 
ny 
2 
tn 
i) 
ta 
o 
ae 

09 

té he) 
(D 
a} 
~~ 

3 
3 
ct 
y 
Ih 
Ih 
(wD 
Ki 
fa 
(t 
i) 
oa 
(D 
fo 
4 
| od 
i?) 
Q 
wo 
ct 
(D 
Qu 
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Block Transfer 
Extract From Terminal Type File 


terminal type: 


framing chars: STX ETX; 


Structure for get framing chars and set_framing chars control orders 


dcl 1 framing chars aligned, 
2 frame_begin char(1) unaligned, 
2 frame_end char(1) unaligned; 


] iflow mode 
| Suspend-Resume input flow control 
] Same as used in output flow control 
[| 1-second timeout possible 


| Causes bigger input buffers to be allocated 
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Sender 


Terminal: 
Terminal: 
Terminal: 
Terminal: 
Terminal: 
Terminal: 


Multics: 


(Silence while Multics waits for OK to resume.) 


Multics: 


Terminal: 
Terminal: 
Terminal: 
Terminal: 
Terminal: 


Multics: 


Terminal: 


(Silence while Multics waits for OK to resume.) 


Multics: 


Suspend/Resume Input Flow Control Protocol with Timeout 


Character 
sent 


X-ON 
£ 

h 

e 

ng 

n 
X-OFF 
P 


X-ON 


Meaning 


Here’s 
Here’s 
Here’s 
Here’s 
Here’s 
Here’s 


a 
a 
a 
a 
a 
a 


character 
character 
character 
character 
character 
character 


for 
for 
for 
for 
for 
for 


you. 
you. 
you. 
you. 
you. 
you. 


Wait, I can’t handle any more for the moment. 


OK, I can handle some more now. 
you. 
you. 
you. 
you. 
you. 


Here’s 
Here’s 
Here’s 
Here’s 
Here’s 


a 


a 
a 
a 
a 


character 
character 
character 
character 
character 


for 
for 
for 
for 
for 


Wait, I can’t handle any more for the moment. 


Here’s a character for you. 


OK, I can handle some more now. 


(Silence for one second) 


Multics: 
Terminal: 
Terminal: 


X-ON 
u 
ct 


I repeat, I can handle 
Here’s a character for 
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Here’s a character for 


some more now. 


Vou 
jv. 


you. 
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Input Flow Control 
Extract From Terminal Type File 


terminal type: 


input_suspend: “S; 
input_resume: “Q; 


Extract from flow_control_info.incl.pll 
Used for get_ifc_info and input_flow_control_ chars control orders 


del 1 input_flow_control_info aligned based, 
2 suspend_seq unaligned, 
3 count fixed bin (9) unsigned, 
3 chars char (3), 
2 resume_seq unaligned, 
3 count fixed bin (9) unsigned, 
3 chars char (3), 
2 timeout bit (1); 
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| Parity 


| Normally send even parity, ignore input parity and strip input parity 
bits 


] All parity is handled in FNP 
] 8bit mode 
| Affects input parity 
| Inhibits stripping of parity bit 
|] Treat parity bit as 8th data bit and receive any 8-bit sequence 
| oddp mode 
| Affects output parity 
[| Generates odd parity instead of even 
[ no_outp mode 
| Affects output parity 


| Generates no parity bits 
a ie nRla.2- 
] If used with rawo any 8-bit sequence can be sent Cet 


] Pseudo-modes 
IT default 
| erkl,can, “rawi,*rawo,“wake tbl,esc 
] init 
[] All modes off, except 1150 
{| force 
| Hide errors in following modes 
| force,replay,polite works on async and X.25 lines 
| Miscellaneous Orders 
| hangup 
| Break connection with terminal 


|] interrupt 
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] Send break to terminal Q 


a ~ 

get_channel_ info Via en) 0 heer a 
wice Va \ oe S Ss 
| Can get devx to use in direct hes_ calis oe Oy yer 
NN 
soo gs 
start ?) 
<? 


] Sends an extra wakeup 

J] Should be used by programs that wakeup and do terminal I/0 
terminal_info 

] Get information such as line speed 
write_status 

|] Find if any buffers waiting to be sent to terminal 
read_ status 

] Find if any input buffers waiting to be read 
abort 

|] Flush input and output buffers 
resetread 

] Flush input buffers 
resetwrite 

[| Flush output buffers 
get_event_channel 

] Find out event channel for wakeups 

| Useful if need to wait on more than one channel 
set_event_channel 

| Change event channel used 


[ Useful if want to use event-call channel instead of event-wait 
channel 
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LOAN 
16 atacw x yey lel FOO 
pore C00 Henman. Mul JICS 


gm tty_ attach description 
] tty_ {device} {-control_args} 
| tty_ LINE 
|] Attach LINE as slave line 
|] LINE can be generic destination 
] tty_ LINE -destination DESTINATION 


[| Attach LINE as autocall line with specified phone number or network 
address 


[| LINE can be generic destination 
] tty_ -dial_id STR 
|] Wait for ‘dial STR’ on a login line and attach 
[ tty_ -login_channel 
[| Attach login channel without knowing name 
] -resource STR 
{| Ask for line of a certain speed 
| -no_hangup_on_detach/-hangup_on_detach 
| Default is -hangup_on_detach 
| -suppress dial manager 
|] Use if process already has line owned or on loan 
|] Used by Initializer 
| Used for login channel 
] Used if dial_manager_ calls have already been made 


] -no_block 


] Never go blocked on input or output 
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MCS Ring 0 Internals 


a Databases 
| tty_buf 
] Wired, contains most wired data for Ring 0 MCS 


|] All information used during interrupt handling must be wired 


| Buffers 
[ WICBs Sie rae (Ontrol Glock 
| LCT hapicek 6hos. Vae'e 


[| Size is specified with PARM TTYB card in config deck 
| Default is 6K 
[ Too small for average configuration 
| Size requirement can be calculated 
] CC75 Appendix C 
| Meters can show utilization more Poactital 
| Header contains meters and pointers to other data within tty_buf 
] LCT 
[ Logical Channel Table 
[| In tty_buf 
[| One entry (LCTE) for each entry in CDT 
j For each FNP, multiplexer, non-muitiplexed channel 


[| LCTE has pointer to data for FNP, multiplexer, or 
non-multiplexed channel 


] WICB or fnp_info or multiplexer-specific data 


|] For FNP or mpx, this data contains pointers to descendant 
LCTEs 


] LCTE has pointer to LCTE of its parent multiplexer 


] index of LCTE in LCT is called devx 


Databases 
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|] devx is what is used in hcs_ calls to identify line 
| LCNT 
] Logical Channel Name Table 
| Parallel to LCT 
J] In tty_area, a paged supervisor segment 
|] Each entry has names of channel 
[| Allows conversion of devx into channel name 


] Used for error messages 


] Wired Terminal Control Block 
| Primary database f Ssaoht, aor pee 1 
ry database for non-multiplexed channe 

[| Database pointer in LCTE of non-multiplexed channel points to it 
[ In tty_buf 
| Data in WICB used during interrupts, so it must be wired 

J] Event channel for waking up process when input arrives 
[ Pointers to active input and output buffer chains 
[| Contains pointer to TCB 


~ 


] TCB contains data about channel that is not used at interrupt 
time 


| TCB 
] Terminal Control Block 
] In tty_area, a paged supervisor segment 
] Has pointers to conversion and translation tables 
| Current and default 
] Bits to indicate modes set 
] tty_tables 


j A paged supervisor segment 
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] Contains tables used during input/output conversion and translation 
] Input translation 
|] Output translation 
| Input conversion 
] Output conversion 
| Special 
] Delay 
| Tables are shared among lines (and hence among processes) 
| Often many lines use same tables 
| Reference count tells when table can be freed 
| f£np_info 
] In dn355_ data, a wired supervisor segment 
] Pointed to by LCTE for FNP 
] Contains pointer to mailbox area for FNP 


] Contains pointer to PCB array for FNP 


|] Physical Channel Blocks 

[ In tty_buf 

] Array of PCBs is pointed to by fnp_info 

| Indexed by channel number 

] Has pointer to LCTE of subchannel 

[ Pointers to I/O buffer chains for subchannel 
] dn355_ mailboxes 

] Contains mailboxes for each FNP 


] Used in FNP<->Multics communication 
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Ring Zero MCS Databases 


| TTY BUF | | Free | | Free | 
| HEADER [-1->| Buffer !-->! Buffer |! 
pee | | | | | 
| DATANET MBX | | | 
Ae ote Se eee, | | 
| | submbx | | | | | LCNT | 
| | 1 | | | | | 
| | | | 
| | | | | 
| | 2 +----- 3----- >| | 
| | submbx | | | | | | 
| | 1 | | | 
Vv sees 
| 2 | : LCT | 
4 j | {| Input | {| Output | 
| ; | LCTE | | | Buffer | | Buffer | 
| FNP_INFO |<----5------ | ma" {| | | | | 
| | | | [ | ° ° 
| | | | | | ae, aes ao See eS 
| | | ° | | Input | | Output | 
| | | 6 | | Buffer | | Buffer | 
| | | | | | f | | 
| | [oad | | | 
| ij | LCTE | | _ 8 ae 
10 +------- >[> *a:hOl0" | | WICB | 
| | | | [Seats Ll--+>| | 
Vv 7 | | | | | | 
PCBs | 
| [sek | | 
| | | | 12 
| | | | | 
| | | V 
| | | | | TCB | 
| 
+-------------- 13------------------ | | 
| +--14--] | 
cn tS rE RS __V = 
| Special | | Special | | Special | 
|Chars Tbl|-->|Chars Tbl|-->|Chars Tbl] 
[eee eet | 
1) tty_buf.free 6) lcte.major_channel devx 11) icte.data_base_ ptr 
2) tty_buf.1let_ptr 7) peb_array(n) .devx 12) wtcb.tcb ptr 
3) .bet. lent per 8) wtcb.fblock 13) tcb.specialrp 
4) inp _info.mbx_ptr 9) wtcb.write first 14) tcb.df_specialrp 


5) lete.data_ base ptr 10) fnp_info.pcb_array_ptr 


Databases 
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mw Programs 
| tty_write 
| Called via hcs $tty_write 
|] Copies user’s output from user ring buffer into buffer in tty_buf 
| May accept only part of user’s output 
|] User ring program must block, await wakeup and call again 
[| Performs output conversion and translation 


[| Calls next level of programs (usually fnp_multiplexer) to send data 
on to FNP 


| tty_index 
] Called via hces_$tty_index, hes $tty_order 
| Handles control orders and mode changes 


[| Pass on to FNP (via fnp_ multiplexer) if order or mode is handled in 
FNP 


| fnp_multiplexer 
| Formats a mailbox and gives it to dn355 
[ dn355 
| Manages DIA 
] Sends interrupts to FNP 
[| Receives interrupts from FNP 
| Exchanges information with FNP using mailboxes 
| tty_interrupt 
[ Called by dn355 for interrupts from FNP~ 
] Tells FNP where to put input data 
[| Allocates input buffers 
| Sends wakeup to process blocked for input when input is available 
[ Touches only wired data, i.e. LCT, WICB, buffers 


| tty_read 
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| Called via hes_$tty_read 

[| Usually called after wakeup is received 

| Performs input conversion and translation 

] Copies converted data from tty_buf into user ring buffer 
| tty_space_man 


] Utility to handle all allocation/freeing of buffers in tty_buf 


Programs 
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wm Multiplexing 


| Connections just described between 


J] dn355 and tty_interrupt on interrupt side 


I 


tty_read/write/index and fnp_multiplexer on call side 


[| are not always direct 


| For multiplexed lines, some intermediate processing is needed 


] Adding control information to blocks of data to be transmitted 


|] Interpreting and removing control information from blocks of data received 


| Multiplexing is generalized using cmtv and channel manager 


] cmtv 


I 
I 


Channel Manager Transfer Vector 
Is indexed by 
| Type of line (type of LCTE) 
[ FNP, X.25 mpx, HASP mpx, non-multiplexed line, etc. 
] Type of operation 


] Read, write, interrupt, control, etc. 


| channel _ manager 


I 
I 


Is called by each program that needs to pass data up or down a level 
For instance 


| By tty_write to send data from user down another level towards 
the FNP 


] By dn355 to send data from FNP up another level toward user 


There are different entrypoints in channel manager for the different 
types of operation 


channel manager looks in LCTE to get type of line 


Uses type of operation and type of line to look in cmtv to find 
program to call 


There is also priv_channel manager, calied for privileged operations 
such as loading an FNP 


Multiplexing 
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LCTE Chaining for Multiplexing 
Non-multiplexed subchannel 


Interrupt-side 


Operations 
[| 
1 
dn355Sinterrupt 
| 
a es Vv 
| emtv(write): | | | | | 
| fnp_mpx$write | | | | | 
| ence ere cee-- | emtv(lcte. | LCTE | lcte | fnp_ info | 
| cmtv(interrupt) |<-------------- | "a" |--- errr renee >| | 
|dn355$interrupt| channel _type) | |data_base ptr] | 
SS ee | | 
l[cte. | peb_array(n) .devx | 
maj _devx| Hanne ee ne en renee eee e- + 
| | 
| | 
ee cee ees =| Vien! 
| emtv(write): | | | | | 
| tty_write | | | | | 
 Satetetieatatatataiatatatatate | emtv(lecte. | LCTE | lcte [ WICB H 
|cmtv( interrupt) |<-------------- | "a.h11o" [------------ >| | 
| tty_interrupt | channel_type) | |data_base ptr| | 
| | 


eee Psa eee 


Call-side 
Operations 


Multiplexing 
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LCTE Chaining for Multiplexing 
X.25 Subchannel | 


Interrupt-side 


Operations 
I] 
1] 
dn355$interrupt 
Sie ene V 
| emtv(write): | | | | | 
| fnp_mpx$write | | i | | 
J o-oo een - eee | emtv(lete. | LCTE | lcte | fnp_info | 
|emtv(interrupt) |<-------------- | "A" penn nnc ce eee- >| | 
[dn355Sinterrupt| channel type) | |data_base ptr| | 
See eed a | | 
| 
lete. | peb_array(n) .devx | 
maj devx| Hann nee ec ee ene een nee ee + 
| | 
| 
ee ee Sr aes aie 
| emtv(write): | | | | | 
| x25 _mpx$write | | | | | 
| ------2----- ee | cmtv(lete. | LCTE | lcte | x25 info | 
jemtv( interrupt) |<-------------- | "a.h120" j---crr rece >| 
[x25 mpx$intrupt| channel _ type) | |data_base ptr] | 
ae Pe | | 
lcte. |! | 
maj devx| Han cnr ene en rere rere eee + 
| | 
| | 
eee eee a Ve 
| emtv(write): | | | | | 
| tty_write | | | | | 
| --------------- | emtv(lcte. | LCTE | lete | WICB | 
j cmtv( interrupt) |<-------------- { “a. hito* | ------------ >| | 
| tty_interrupt | channel _ type) | [20.01 |data_base_ ptr] | 
eee Pee een eereeer! | | 
| 
tty_write 
\ 
1 | 
[| 
Call-side 
Operations 
Multiplexing 
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Multics-FNP Interface 


] DIA Interrupts 
| Submailboxes 


| TIMW 


rirst 8 used 


a 
3 arg started By 
y myuitricS 
5 Reale’ ne Bx S 
( 
2 
g Gul 
Y Ew —mvlTi CS 
! LAgGe mar's (ap \ 


necwally wl 


Becauco Lm RL nes 
Data Ton VOR th se 
QOes ST ea oh 
“Yo m~ (Y x. 


CC 
eS: 


Ye wuly BF Level & Quy ee 
rag MOTs 


yo € nd cones Ponting oF es, 
“ Zs 
ykQ Hddeot sPaces 


Arve WV 
LON Pan ckerved, 


All Tinteravers 


iT Leoks AT Temw 


ma. \®ox On moby aes VS ey) ee wail Lox 


Ve so NO 
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FNP Internals 


um Programs 
] All work in the FNP is driven by interrupts 
] HSLA 
|] Input from a line 
] Status change for a line 
] DIA 
] Mailbox interrupt from Multics 
] Terminate interrupt from I/O started by FNP 
[| Timer 


| No work ever seems to be done directly 


] Everything that needs to be done is put in a queue to be done later 


as time permits 
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FNP WORK SCHEDULING 


Rancg resitic?ed 
Po Cha hs 


MASTER DISPATCHER- - INTERRUPT -DRIVEN 


| 3-WORD JUMP TABLE | 
+--------- $--------- + 


STo 70S sank tne Mid Pixs 


e ~ 
Vo patter Oy cal che Vln 
+ 


F--------- +---+------ * PENDING * 
| SKEDSMDISP ACHKKKAKKEKEKKE INTERRUPTS * 
+--------- +--------- + * * 
| KEKKREREKEEK 
| 
Dian span nn ee nn en eee e wee pan orate eerer ese Soe ese + 
order : : Signal Change ¢ | 
| | lnTetestia4 l 
Pieeelels oboe cues + Pevekesess - Sars. . 4 Posnseue ss pacstaktes + 
| DIA MANSDTERM | | HSLA_MANSHINTR | l SECONDARY | 
j DIA _MANSDMAIL | | l l DISPATCHER l 
+----- +------- +----- + +--+------ +------ +--+ +------------------- + 
* * * * os 
* * * * * 
* * * * * 
eik  onndninkivnek * eee ae se re ce ee ce ee ee os 
* * * * for Une * 
* * * * * 
Vv Vv Vv Vv * 
RRR IE KKKKKKKKEREK Sniokicnk& kek 
* MAILBOX * * TIMER * * SOFTWARE * * HARDWARE * 
* QUEUE * * QUEUE ¥* * STATUS * * STATUS * 
* * * * * QUEUE * * QUEUE * 
KEKKKKEEEEEE Ikki KKK KEKKKKKKEEKEK 
isT OF welk geferse 
ee ¥ S ale Uni { ( ale | a 
To Be \eckod AY 
Programs 
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FNP WORK SCHEDULING 


SECONDARY DISPATCHER--QUEUE DRIVEN 


KAKKEEAKEIE 
* TIMER * /woS? Thrays here I Toly 
* QUEUE *& nood Po fe Dong Immedia 
*« * 
dnnnnnioek Soeickiek SEE 
* MAILBOX * * “SOFTWARE * 
* QUEUE * v * STATUS * 
* * Rs a wtctee a peed dhe + * QUEUE * 
KEIR | SECONDARY l SK 
* | DISPATCHER | * 
* fen--e--e- pocose-s-- + * 
* l * 
* l * 
* | * 
* Possess bebo a see eceeteeeaane an enn ee eee eee eee + * 
* | ; 
OL Es Rha, | 3 
v v Seat Fromm VvfT | vov 
Se ee ee + | fase ascees $---t----- + 
| DIASDGETWK +i l | HSLASHSTPRC | 
| | = | | | 
pen eee--- Pate teieeere + * | See Possess + 
| : | 
v v Vv 
ee pita eelae se ge ae eae Pos Seeeeex + Hd (es (a ee zs 
| INTPSITEST | * | INTPSTTIM l | INTPSISTAT 
| INTPSIWRITE | * | | ! 
eos emis Hose etets + x -speeseeee se eee + $o----+--- +iseeeeees + 
| | | 
Vv * Vv Vv 
poe seueees oe ee + x  peeeseoeas fesse eens + $osseesses $--------- + 
| CONTROL_TABLES * | CONTROL TABLES | | CONTROL TABLES | 
| | “4 | | | 
$atoeee ws possesses + ee poe------- + Spi aumidte Stal Piceetaces + 
| = | | 
Vv * Vv Vv 
+--------- +--------- + * t--------- ++--------- + +--------- +--+------- + 
| MISC UTILITIES | * | MISC UTILITIES | | MISC UTILITIES | 
| | ~ 4 | | | 
$u-------- $+-------- + a es $oeee----- + $ustsesece pr eceesse- + 
* * * * 
* * * * 
Jheencek Ok dainkiinkinndek * 
vy * YW * 
re i saa ae ey 2 
* REQUEST * * 
QUEUE 84K RIAA AHH A EEA A AKA A HARARE AREER EEE 
KEEREIIREEE 
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Interrupt 
Vector 


0| addr (handler) | 
Perea 
A TPC TST 
‘eee 


ep eras 
4| addr (handler) | 


[ee ea 
5 | addr (handler) | 


h@RWrnre LofTaare Mandl 


Three-Word Jump Table 


OD @\ Jotegiaek jnSTeruclion Se 


Socd oF 


Handler 


tsy indirect = 
Pena Saeses >jIC at intp time] 


Handler 
Code 


i. 


oxPonided rato! 


Ne 
~ (ndervp)s 


handler 


eereese tenes owen aenn eee wer ewewowernoaonewewennzn ewer eevewenrnwzweweeeceeeee2enewewecewewewtenwneenn ew e2reee ee =a © © 


Interrupt 
Vector 


0|addr(handler) | 


a ee 
1| addr (handler) | 


Dinas de eee 
2 | addr (handler) | 


ee ee 
3| addr (handler) | 


| | 
4|addr(handler) | 


ee ne ee. 
5|addr(handler) | 


Piles ee i 
° 
° 
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tsy indirect 


Three-word 


Jump Table Handler 
RE Ee PRE tsy pee as ete 
we ee cree -ee- >{IC at intp time] +--------->|IC from 3wjt tsy| 
aaa ee Oe ee ey | 
[tsy to handler |--+ | Handler 
tes ye ees eta | | Code 


| ioc/devid/mod |<----+ 


J}ic at intp time] 


| ioc/devid/mod | 
aaa eee 


eee >|IC at intp time| | 


[tsy to handler |---+ | 


j ioc/devid/mod {<----+ 


JIC at intp time| 


| ioc/devid/m 


! 
i 
pe Beer ee 
; 
: 


| ee | 


Line none on SLA 
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| scheduler (sked) 


I 
I 


Schedules work to be done 

skedSinvp is the primary interrupt handler. 
sked$mdisp is the master dispatcher 
skedSdspqur schedules work for later handling 


The secondary dispatcher runs work queued by dspqur 


[| hsla_man (hsla) 


I 
I 
I 


Controls HSLAs 

hslaShintr handles HSLA interrupts 

hslaShstpre does work queued at interrupt time 
hslaS$hdew accepts output commands from control tables 
hslaShcfg handles configuration changes 

hsla$hmode handles mode changes 


hsla$hgeti handles replay and polite modes 


|] dia_man (dia) 


I 
I 
I 
i 
I 


Controls the DIA 

diaS$dterm handles DIA terminate interrupts 
dia$dmail handles DIA mailbox interrupts 
diaSdgetwk does work queued at interrupt time 


dia$denq accepts data to be sent to CS 


| interpreter (intp) 


I 


Control Tables Interpreter 


] control tables, etc. 


I 


Implement the communications protocols 


] utilities (util) 


I 


[ melt 


Utility subroutines 
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| COLTS hardware tests 
] trace (trac) 

] Puts trace information in trace table 
] meters (metr) 

[| Collect meters for channel_comm_ meters 
] init 


| FNP initialization program 
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sm Databases 
| Communications Region 
] Global database for FNP 
] Pointers to other databases in FNP 
] IOM Table 
|] Used during initialization and to refind HSLA Table to find TIB 
| TIB 
| Terminal Information Block 
|] Main per-channel database 
[. Contains data used by many programs 
| Stored in extended memory 


|] TIB, SFCM and two buffers permanently allocated to channel are stored 
in a 256-word page 


| Page is addressed using page table entry 4177 (addresses 77400-77777) 


[| Software Communications Region 
] Per-channel 


] Contains information for HSLA for channel 


| Hardware Communications Region 
| Per-channel 
] Contains control words for HSLA 
] Pointer to CCT for channel 
|] CCTs are shared, similar to tables in tty_tables 
] Pointer to SFCM for channel 
| Stored in low-order memory, address known by hardware 


| HSLA Table 
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[ Pointed to by IOM table 

[| One two-word entry per channel 

[ Entry contains pointer to TIB 

[| Finding the TIB for a given channel is its main function 
[ TIB Table | 

[ One 2-word entry per channel 

|] Not arranged in any particular order 


| Each entry contains a pointer to TIB and a pointer to outstanding DIA 
requests for channel 


[ DIA Requests are stored in low-order memory 
| TIB Table plus these DIA requests make up the DIA Queue 
| Buffers 
| Are mainly allocated in extended memory 
|] Addressed using page table entry 4176 (addresses 77000-77377) 
| Free space chained from .crnxe 


] If no free space in extended memory, can use free space in low-order 
memory 


[| Normally used for CCTs, DIA.requests, etc. 
| Free space in low-order memory is chained from .crnxa 
| Buffer Requirements 

| Can be calculated using CC75, Appendix B 


] There are meters to show utilization 
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FNP Databases Excluding I/O Buffers 
(Per-Channel Databases Shown for a.h205) 


| Free | | Free | | Free | 
crnxa->{| Space |-->| Space |-->| Space | 


640-->|] Comm 
| Region 


|-. 

| 

| Sane oe pie te erie ae 
| | Free | | Free | j Free | 
|-.crnxs->| Space |-->| Space |-->| Space | 
| 
| 
|-. 
| 
|-. 


+-.crttb- ecriom---------- >| IOM | +----- >|HSLA Tbl | 
| | Table | | | HSLA O | 
| erect+ ee ae | | | | 
| 2 ala Renee pemet | 
| | thO=s>] J Lasoo e + | | 
| te ee es ae) A (eee | 
| | Pe, | | +-->]|HSLA Tbl | 
| ee | | HSLA 1 | 
| 1000-->] HWCM ] | | | | 
| | HSLA O | | | | | 
| | | | | | | 
| | | | | | 
| | | sae | ee | 
| | | | +----- >|HSLA Tbl | 
| | | | | HSLA 2 | 
} 2000-->{ HWCM | | Bes wy cen Ze | 
H { HSLA 1 | | #5%2-->[0 j-+ 
| | | | | | | 
| | | | | | 
| | | | | 
| Vv | 
| 3000-->| HWCM | | ccT i | ccT { | ccT | | 
| | HSLA 2 | [Peer >| [= eae ae 
| | | | | | | | | 
Uh iin cy | | | 
| 3000-->| | -h. baw--------------------- + | 
[ +5416 [| o _ _ | -h.sfcem--+ So ee ee | 
| {i +------- >| SFCM |\<-------- + | 
| | | | 
| +-sf.tib*-| | | | 
| | | | | | 
| +-------- >| TIB |<-----------+---------- + 
+------- >| TIB | +-------- >| | | 
{| Table | | j |-t.sficm*-+ 
enna | | 
| [Hsomnrss + | 
Ps lar Bs init + | | 
| | i | 
| 
| Beets Wet re fe ne 
{| DIA I j DIA j j DIA | 
|Request |----- >jRequest |---->|Request | 
Pesto ee | eee 
Databases 
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Ewtsy 


FNP I/O Buffers 


Comm | | Free | | Free | | Free | 
Region |-.crnxe->| Buffers |-->| Buffers |-->| Buffers | 
| ee a Ce eee ee | 
| 
HWCM | 
| -h.sicO------------------ een nn eer ene nee r nner rene + 
| -h.sicl------------------ 2-2-2 errr rrr r ee + | 
j -h.ric0O----------- + | i 
| -h.ricl-+ | | | 
| | | | 
| | | | | 
| nk _Vv_ ne: See, aS a 
| | Icw | | Icw | | Icw | {| Icw | 
| | I | | | | Vee tesa 
| |__ — ESE eee Ss, seer 
| | Input | | Input | {| Output | {| Output | 
i [Buffer 1 | {Buffer 2 | ; |Buffer 1 | [Buffer 2 | 
| ae ee eee ieee | 0 | 
| | | | | 
| | | | | 
| | | ro) ; | | 
[ | +---sf.ibt--+ +--sf.obO~--+ | 
| | | | | 
| $e 2 reece eee -e-- sf. ibd--+ | | Fane ees ieieteteiateietataletaiataien + 
| Lid | 
| lle = 
+--h.sfem---------------------- >| SFCM |<-------- + 
| | | 
+-sf.tib*-| [ | 
| | | | 
+-------- >| TIB | | 
| |-t.sficm*-+ 
+--------- t.dep------------------ | | 
| +t.dclst- | | | Echo | 
__V as, | [---t.echo-->| Buffer | 
| Buffer {| {| Buffer {| | Buffer | j j { | 
{for DIA |->|for DIA |->]for DIA | | | 
po TL Ate ve | a 
ee t.icp--+ | | +--t.olst----------- + 
| +--t.ilst--+ | | 
| | t.ocur | 
| | | | 
a Pt ee _ Vv __V ee A a 
| Input | | Input | | Input | {| Output | | Output | | Output | 
| Buffer |->| Buffer |->| Buffer | | Buffer |->] Buffer |->| Buffer | 


Whe _ _ 
an ahe f [ ne steod ch Age’ — \ he BvFrek 
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500 

640 

776 

1000 

.crept 
.criom 
.criom+15 ,* 
.crmod-22 
.crttb 


.crbuft 
(=.crtte) 


77000 
100000 


100000+ 
#lines*400 


.crtrb 


FNP Internals 


#hslas*1000 


200 


40 


#hslas*100 


variable 


#lines*2 


variable 


77777 


#lines*400 


variable 


.crmemn- 
.crtrb 


FNP MEMORY LAYOUT 
Explanation . 
Interrupt Vectors 
Fault Status Words 
Fault Vector 
Mailboxes 
Page Table Address 
LSLA HWCMs 
Communication Region 
Missing Module Code 
HSLA HWCMs 
CPU Page Table 
IOM Table 
HSLA Tables 
Program eeaiies 


TIB Table 


Low memory buffer pool (for TIB extensions, 
CCTs, DIA queue, delay tables) 


Unused Pages 
SFCM/TIB pairs, I/O Buffer pool 


I/O Buffer pool 


Trace Buffer 


Databases 


F86 Page 6-11 


display_fnp_symbols: proc; 


/* Program to list all the symbols which are understood by debug fnp */ 


/* Coded 19 August 1980 by Jim Homan */ 


del i fixed bin; 

del ioa_ entry options (variable); 

t$page; 

include debug fnp_ data; 

$page; 

symbol _tablep = addr (db _fnp_symbols $db_fnp_symbols ); 


call ioa_ ("Symbol Value Length Explanation’/") ; 


do i = 1 to symbol _table.cnt; 


exptextp = addrel (symbol tablep, symbol _table.entry (i).explain); 


call ioa_ ("°10a%100°10d “a", symbol_table.entry (i).name, 


symbol table.entry (i).value, symbol _table.entry (i).len, 


exptext.data); 
end; 


end display_fnp_ symbols; 


Databases 
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Communications Region 


Name Address Length Explanation 
.crldt 640 4 date and time of binding 
.crbdt 644 4 date and time of bootloading 
.crbuf 650 1 starting address of buffer area 
.crmem 651 1 last location of memory 
.crnbf 652 1 number of buffers available 
.criom 653 1 start of iom table 
.crnhs 654 1 number of hsla’s configured 
.crnls ~ 655 1 number of lsla’s configured 
.crcon 656 1 console enabled flag 
.crmod 657 1 starting address of module chain 
.crnxa 660 1 ptr to next avaliable buffer 
.crtra 661 1 trace entry enable mask 
.crtrb 662 1 base address of trace table 
Jexere 663 1 next available location in trace table 
.crreg 664 1 disaster fault register storage location 
.crttb 665 1 location of tib table 
.crtte 666 1 location of end of tib table 
.crdly 667 1 head of delay table chain 
.crver 670 2 mes version number, 4 chars 
.erbrk 672 1 addr of breakpoint control table 
.crtsw 673 1 if non-zero, tracing will cease 
.crnxs 674 1 next free small block 
.crnbs 675 1 number of buffers devoted to small space 
,Crect 676 1 address of first cect descriptor 
.crskd 677 1 address of scheduler data block 
.cretb 700 1 list of echo-negotiation bit tables 
crept 701 1 address of cpu page table 
.crpte 702 1 address of variable cpu page table entry 
.crtsz 703 1 size of trace data buffer 
.crmet 704 1 non-zero if metering enabled 
.crtdt 705 1 address of tib for t&d executive channel 
.crbtm 706 1 address of time meters for getbuf/frebuf 
.crnxe 707 1 next available space in extended memory 
.crbpe 710 1 buffer paging window table entry 
.crepr 760 14 copyright notice 
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TIB 


Name Address Length Explanation 
t.stat 0 1 holds current line status 
t.flg 1 1 flag word 
t.£1g2 2 1 second word of flags 
t.cur 3 1 current address in control table 
t.line 4 1 10 bit line number 
teicp 5 1 first buffer in input chain 
t.ilst 6 1 last buffer in input chain 
t.icpl 7 1 count of buffers in icp chain 
t.icch 10 1 address of next input character 
t.elnk ak 1 link to tib extension 
t.rep 11 1 replay chain pointer (share t.elnk) 
t.ocp 12 1 addr of output chain from cs 
t.ocur 13 1 addr of current output buffer 
t.olst 14 1 addr of last buffer in output chain 
t.occh 15 1 addr of next output character 
t.ocnt 16 1 count of buffers in t.ocur 
t.type 17 1 line type 
t.time 20 2 time at which next timeout will occur 
t.reta 22 1 return address from calsub 
t.dcewa 23 1 addr of dew list to ‘execute’ 
t.dewl 24 1 length of dew list 
t.echo 25 1 echo buffer address 
t.dep 26 1 addr of message chain for cs 
t.dlst 27 1 last buffer in messge chain for cs 
t.ftse 30 1 first time slot entry in Isla table 
t.sfcm 30 1 pointer to sfem for hsla lines 
t.bent 31 1 counting temporary 
t.brkp 32 1 pointer to current break list 
t.pos 33 l current carriage position 
t.char 34 1 pending line control char (l1sla only) 
t.ecch 34 1 address of current echo char (hsla only) 
t.cntr 35 1 counter for control tables 
t.£1g3 36 1 third word of flags 
t.dtp 7 1 pointer to delay table for this line 
t.frme 40 1 framing chars (2 chars) 
t.depl 41 1 number of buffers in dep chain 
t.sell 42 1 screenline length left, for echo neg. 
t.snec 43 1 Echo negotiation sync ctr. 
t.entp 44 1 Echo negotiation break table ptr 
t.ifch 45 1 input flow control characters 
t.ofch 46 1 output flow control characters 
t.omet 47 1 output message count (for flow control) 
t.itim 50 2 time of last call to inproc (2 words) 
t.metr 52 1 address of metering area 
t.abf0 53 1 absolute address of first permanent buffer 
t.abf1 54 1 absolute address of first permanent buffer 
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Name 
tfosus 
tfecpx 
tfisus 
tfeotx 
tfauto 
tfiwabt 
tfitbec 
tfcrec 
tflfec 
tfetrl 
tfquit 
tflisn 
tfhang 
tfprtr 
tfikybd 
tffidpx 
tfbel 
tfiwrit 
tfdlup 


Name 
tfpfnl 
tfsftr 
tffip 
cffirmi 
tfimrev 
tferev 
tfiblak 
tfiplit 
tfrpon 
tfirply 
tfupsf 
tfofc 
tfife 
tfacu 
tfrabt 
tfercv 
tfdild 
tfixhld 


FNP Internals 


Address 
-400000 
200000 
100000 
40000 
20000 
10000 
4000 


Address 
-400000 
200000 
100000 
40000 
20000 
10000 
4000 
2000 
1000 
400 
200 

100 

40 

20 

10 

4 

2 

1 


iy 
@ 
ry 
ct 
a 


ee 


Flags for tib.flg 


Explanation. 

output suspended 

echoplex mode 

input suspended 

eot expected from 2741 
this is hsla autobaud line 
do write abort 

do space echo on tab 

do cr echo on lf 

do 1f echo on cr 

do kybd/printer addressing 
send nl on line break 
answer the phone 

hangup this line 

printer addressed 
keyboard addressed 

full duplex mode 

send bell as next echoed character 
output chain present 

line is on dialup modem 


Flags for tib.flg2 


Cc 
@ 
g 
= 


PRP RE REE PERE Pe Pe ee eee 


Explanation 

line is in prefixnl mode 
terminal is shifting device 
frame in progress 

frame mode 

‘message’ receive mode 
‘control’ receive mode 
asynchronous block acknowledgement 
polite mode 

replay is occurring now 
replay mode 

terminal is upshifted now 
output flow control mode 
input flow control mode 

do dial out 

do read abort 

enter receive mode 

terminal is dialed up 

hold transmit on 
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Name 
tfimask 
tfabf1 
tforp 
tfsoip 
tfabf0 
tfoddp 
tf£8out 
tf8in 
tisked 
tfbral 
tfecho 
tfikpar 
tfitim 
tfibkpt 


Name 
tsferqg 
tsfrts 
tsftre 
tsfsxt 
tsfdtr 
tsfbrk 
tsfxmt 
tsfrev 
tsftrm 
tsfmrk 
tsfst 
tsfsre 
tsfdsr 
tsfcts 
tsfcd 


FNP Internals 


Address 
20000 
10000 

4000 


Address 
20000 
10000 

4000 
4000 


i 
@ 
3 
t 
5 


ee 


Flags for tib.flg3 


Explanation 

channel has been masked for excessive interrupts 
t.abfl available 

output resume pending (waiting until tro) 
suspension of output in progress 

t.afbO available 

odd parity 

don’t strip output parity 


don't strip input parity 


input timeout routine scheduled 

break on all characters 

echoing has priority over output (lsla) 
keep parity bits’ 

timeout if input stops 

line is stopped at breakpoint 


Flags for tib.stat 


tC 
@ 
=) 
ot 
to 


ee ee 


Explanation 

acu call request 
request to send 
tally runout enable (hdlc) 
supervisory transmit 
data terminal ready 
send line break 
transmit mode 
receive mode 

send terminate status 
send marker status 
store status 
supervisory receive 
data set ready 

clear to send 
carrier detect 
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SFCM 


Name Address Length Explanation 
sf.hem 0 1 addr of hwcm 
sf.nxa Z 1 addr of next available queue entry 
sf.nxp 2 1 addr of next queue entry to process 
sf.tly 3 1 tally of status queue 
sf.tib 4 1 addr of tib for this line 
sf.flg 5 1 flag word 
sf.ib0 6 1 pointer to input buffer 1 
sf.ibl 7 1 pointer to input buffer 2 
sf.ob0 10 1 pointer to output buffer 1 
sf.obl 11 1 pointer to output buffer 2 
sf.pew 12 1 current pew 2nd word 
sf.ecct 13 1 eect addr for this line, if non-zero 
st.ret 14 1 repeat count for status queue overflows 
sf.hsl 15 1 address of hsla table entry for this line 
sf.bsz 16 1 max buffer size 
sf.fbs 17 1 buffer size to be used during frame input 
sf.mms 20 1 maximum synchronous message size 
sf.csz 20 1 current asynchronous buffer size 
sf.rms 21 1 remaining unallocated message length 
sf.nic 21 1 char. address of next asynchronous input char 
sf.noc 22 1 char address of next asynchronous output char 
sf.ssl 23 1 number of entries in software status queue 
sf.cfg 24 2 2 words for config pew 
sf.sta 26 12 hardware status q, sicw here 
sf.waq 42 40 wrap around queue, software status q 
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Name 
sffhdl 
sffssb 
sffnib 
sffofr 
sffimsp 
sffsyn 
sff£sqo 
sffbse 
sffstp 
sffdet 
sffech 
sffebd 
sffset 
sffisc 
sffcoi 
sffcii 
sffiskd 


FNP Internals 


Address 
-400000 
200000 
100000 
40000 
20000 
10000 


cE 
@ 
=) 
ct 
> 


ee a ee ee 


Flags for sf.flg 


Explanation - 

uses hdle channel board 

copied alternate buffer back to output chain 
need to allocate new input buffer(s) 

old setting of tffrmi (lines up on tffrmi) 
marker status pending 

any synchronous line type 

status queue overflow pending 

binary synchronous device 

stop channel, rxmit done 

dynamic (sharable) cct in use for channel 
tab, cr, 1f£f echo going on now 

ebcdic data code on this line 

short cect flag 

inactive subchannel flag 

on if alternate output icw is active 

on if alternate input icw is active 

status processor is scheduled 
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HWCM — 


Name Address Length Explanation - 
h.ricO 0 2 primary receive icw 
heriel 2 2 alternate receive icw 
h.sicO 4 2 primary send icw 
h.sicl 6 2 alternate send icw 
h. baw 10 1 base address word 
h.sfcm il 1 software comm. region address 
h.mask 12 2 mask register 
h.aicw 14 2 active status icw 
h.entg 16 2 configuration status 
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Name 
.dql 
.dqu 
.nst 
nsu 
,over 
.par 
.Ssqo 
hsqo 
inaf 
eql 
exh 
xte 
leng 
prex 
.ebof 
quit 
asyl 
-nim 
-iml 
mini 
maxi 
-nom 
oml 
mino 
maxo 
entl 
ent2 
.ent3 
ent4 
.ents 
.cnté6 
-cnt7 
cents 


.synl 


HHS HBP HBRP BPE RBBB BRP BRB BEB RP RP RPP BBB RBBB BB 


FNP Internals 


Address 


b 
=) 
tt 
= 


RAM NNN NM NM DD FR RMD RR ND DR RN OD Pb RED OR Re FR rR er FP DS ND fo 


FNP Line Meters 


Explanation - 


cumulative length of dia request queue 


updates of m.dql 

cumulative no. of pending status 
updates of m.nst 

output overlaps 

parity errors 

software status queue overflows 

hardware status queue overflows 

input allocation failures 


current length of dia request queue 


exhaust status 
software xte status 


length of common meters (must be even) 


pre-exhaust status 
echo buffer overflows 
bell-quits 


total length of asynchronous meters 


number of input messages 
cumulative length of input 
minimum length of input message 
maximum length of input message 
number of output messages 
cumulative length of output 
minimum length of output message 
maximum length of output message 
first type of counter 

second type of counter 

third type of counter 

fourth type of counter 

fifth type of counter 

sixth type of counter 

seventh type of counter 

eighth type of counter 

total length of synchronous meters 
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MCS Metering 


| display_cdt 
] tty_lines 
| system_comm_meters 
| channel_comm meters 
| debug fnp 
] bstat 
] sample _ic Lavoletecs Teo | 
| fnp_idle 
[| interrupt_meters Ringn 8 Global! 
| fnp_throughput por caTeres Vind 
| meter_fnp idle QGepter a Te Chal: os . sls a, 


a apg ee ele 
| display_fnp idle So net 
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CDTE at 515|2460 


poet OVA Ty: plexelS 

in_use: fof 

name: 

Multiplexer data: 
service_type: 
mpx_type: 
state: 
initial load: 
last load: 
last crash: 
load started: 
flags.go: 
flags. listening: 
current_service_type: 
current_mpx_type: 
n_bootloads: 
last_tbf: 

comment: 

charge type: 

service type: 

current_service_ type: 

dim: 

line type: 
terminal type: 

baud_rate: 

fnp_no: 

event: 
tra_vec: 

count: 

twx: 

state: 

current_terminal_ type: 

cur_line_ type: 

tty_id_ code: 

process: 

next_channel: 

n_dialups: 

n_logins: 

dialed _ up time: 

dialup time: 
recent_wakeup_count: 
recent _wakeup_ time: 


MCS Metering 


display _cdt 


1 Chung up) 
a.h006 


1 (active) 

11 (x25) 

4 (up) 

02/09/84 1533.7 hfh Thu 
02/20/84 1730.2 hfh Mon 
02/20/84 1601.2 hfh Mon 
02/20/84 1730.2 hfh Mon 
1 

i 

1 (active) 

11 (x25) 


X.25 major channel 

0 (none) 

8 (multiplexer) 

8 (multiplexer) 

1 (tty) 

17 (X25LAP) 

X25_TRANSPAG 

1200 

1 (a) 
000330011502407777000673 


0 (none) 


77777 {1 

0 

0 

0 

0 hrs O mins O secs. 
never 

0 

never 
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CDTE at 515]2620 


in_use: 

name: 

comment: 
charge type: 
service type: 
current_service type: 
dim: 
line_type: 
terminal type: 
baud_rate: 
fnp_no: 

event: 
tra_vec: 
count: 

CW: 

state: 


current_terminal_ type: 


cur_line type: 
tty_id_ code: 
process: 
next_channel: 
n_dialups: 

n_logins: 

dialed_up time: 
dialup time: 

recent _wakeup_ count: 
recent_wakeup_time: 


MCS Metering 


display_cdt 


(hung up) 

.h006.d01 

.25 dial _out sub-channel 
(none) 

(dial out) 

(dial out) 


COrRFAA OM DD 


000470002046407777000151 
18 (wait_slave_request) 
0 


77 

1 (hung up) 

0 (none) 

none 

77777|1 

0 

1208 payne have Geer 


210 hrs 58 mins 37 secs. 
02/20/84 1623.0 hfh Mon 
1 

02/20/84 1730.2 hfh Mon 


Shauid (eSel_<dfin eters 
Once wegk e7 wOHTh 
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display_cdt 


CDTE at 515]3560 


in_use: 5 (logged in & proc) 
name : a.h006.001 

comment: X.25 login sub-channel 
charge type: 0 (none) 

service type: 1 (login) 
current_service_type: 1 (login) 

dim: 1 (tty) 

line_type: 0 (none) 

terminal type: ASCII_CRT 

baud_rate: 1200 

fnp_no: 0 () 

flags.attributes: dont_read_answerback,check_acs; 
event: 000330011356407777000132 
tra_vec: . 8 (wait_logout_sig) 
count: 

twx: 62 

state: 5 (dialed up) 
current_terminal type: ASCITI_CAPS 

cur_line type: 1 (ASCIT) 

tty_id_code: none 

process: 366|1330 

next_channel: 0 

n_dialups: 2788 

n_logins: 2180 

dialed_up_time: 886 hrs 32 mins 32 secs. 
dialup time: 02/20/84 1801.3 hfh Mon 
recent_wakeup_ count: 2 

recent _wakeup_ time: 02/20/84 1801.6 hfh Mon 
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interrupt_meters 


Total metering time 0:10:19 
IOM Ch Int Avg Time % CPU 
A 6 1 1.795 0.00 
A 8 1417) 39 0.552 0.13 
A 9. 10 0.457 0.00 
A 12. 90 0.563 0.01 
A 14 174 0.531 0.01 
A 16 2579 0.545 0.23 
A 17 60 0.495 0.00 
A 18 324 0.579 0.03 
A ~ 20 2825 0.570 0.26 
A 22: 418 0.481 0.03 
A 23. Ll 0.276 0.00 
A 26. 9: -1, 237 0.00 
A 28 7748 = 2.732 3.42 

Chan 15656 1.632 4.13 

Ovhd 15605 0.159 0.40 

Total 15605 1.796 4.53 


MCS Metering 


Name 


IOM A special 
dska 


> yy gC COV Cor Fre \nioreufis 
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system_comm meters 


A 


sis Be prof: Pied 
age ec) work, 


_ oY = 
C Sais CAnanel Com mercds 


Con ol» lea/c4 ( fece T 


HOT SE muck use 


Total metering time 0:10:03 
THROUGHPUT 
before conversion after conversion ratio 
Total characters input 4,705 0.93 
Total characters output 153 ,567 123,256 0.80 
Average length of input 5.1 characters 
Average length of output 73.3 characters 
Input characters preconverted 0 (0.0% of total) 
read ite 
Number of calls 1,436 2,495 
Average time per call 2.13 msec. 5.09 msec. 
Average chars. processed Doe 61.6 
Average chars. per msec. ys 12.1 
Fi rot en doves} n4 
CHANNEL INTERRUPTS 
input output other total 
software "interrupts" 3,243 i Sree lea 113 6,511 
average time (msec.) 2.45 1.02 2.36 1.76 


SHALE ta TH y- BvF Anco, PEC 
®Ther STvFF. 


Te R 25} ond 


Total size of buffer pool 19,368 words 
Number of channels configured 191 


TTY_BUF SPACE MANAGEMENT 


Number of multiplexed channels 18 
% of buffer pool in use current average 
input 8.3 8.4 
output 13.8 13.6 \ 
control structures 51.1 51.2 reje's witcb5 
total 73.2 73.2 Shavit Be [eee thay Ga % &s 


Motmal Srem + @ 
Smallest amount nd free space ever 2,594 words (13% ot buffer pool) Should né/ We 


Since Boel Ce LSA” ob5e 
allocate free total 
Number of calls 6,755 5,894 12,649 
Average time per call (msec.) 0.5 0.5 0.5 
% of total CPU 0.6 0.5 1.0 


0 (0.00% of total) 
No data. msec. (0.00% of total CPU) 
0 (0.00% of attempts) 


Calls requiring loop on tty_buf lock 
average time spent looping on lock 
Number of allocation failures 


CHANNEL LOCK CONTENTION Not cn vPcesh aes 
12,963 
554 (4% of attempts) 


7.93 msec. 
3675.17 msec. 


Number of calls to tty_lock 

Times channel lock found locked 
Average time spent waiting for lock 
Maximum time spent waiting for lock 
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AT 84 


Interrupts queued because channel locked 553 (8.5% of interrupts) 


e Deo + EMeCcS 
RcHO Necotiation fOr WP? 


Average time of transaction 1.7 msec. 

Chars. echoed by supervisor 389 ( 7.72% of input chars) e¢har4 OF 

Chars. echoed by FNPs 353 ( 7.00% of input chars) § @mats KF KOT 
's Tye Sane: 
Pchals : ar 

ABNORMAL EVENTS ala 


Input restarts 0 (0.00% of read calls) 

Output restarts 0 (0.00% of write calls) 
Output space overflows 0 (0.00% of write calls) 
"needs _ space" calls 0 


DH TVines Couldn't do ODFEY  Contertiny Ve TY Bu) sil 
4 7 y 


CESS See “Oi “Grea Pade 
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channel comm meters 


Total metering time 78:15:27 


a 
FNP has been up for 78:15:25 
Number of channels configured 73 
Average number dialed up 54.2 
FNP idle 67.0% di 
Idle at peak load 0.0% anel Bel reve hle USQ Kh 1812 
Input Output 
Characters transmitted 7,941,871 38,672,473 
Characters per second 28 137 
Abnormal DIA status 0 [Ee 
Memory EDAC errors O~ not cens,BPeat ly 
Q, Check pag nory 
Memory size 64K 
Total available buffer pool 17,888 words 
Avg. amount of free space 2,448 words Jobe 


Average % of buffer pool available -13.7 
Number of buffer allocations 3,245,838 
Number of buffers preallocated 900,660 ( 27.8% of allocations) 


Used preallocated buffer 900 , 656 ; 
No preallocated buffer available 126 l- boul 
Buffer allocation failures Onwdiceles Gell Quis ¢5 32 G 
Output restricted by space 0 
Number of interrupts from this FNP 1,996,459 
Avg. time/interrupt (ms) 3329 
% of total CPU time 233 
Mailbox transactions: 
Input data 756,349 
Output data 557,909 
Input control 563,976 
Output control 122,001 
Total 2,000,235 
Average inbound mailboxes in use 0.2 
Average outbound mailboxes in use 1.0 
Maximum outbound mailboxes in use 8 
No outbound mailbox available 56,638 C. ONT _pr 
Input rejects 3 nor enovg, Sface s-  O i 
% of input transactions rejected 0.00 


Total metering time 78:15:30 -—» Hoey with ne <v Cane 
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channel comm meters 


a.ho0o0o0 

before conversion after conversion Yatio 
Total characters input 3,471 3,274 0.94 
Total characters output 874,287 1,243,897 1.42 
Average length of input 5.0 4.7 
Average length of output 60.9 86.6 

read - write control total 

Number of calls 690 14,361 98 15,149 
Average time per call (msec. ) see 8.6 36.6 8.6 
Average chars. processed per call 5.0 60.9 
Number of software interrupts 10,891 


Average time per interrupt (msec.) 1.2 


input output 
Effective speed (cps) 0.0 0.0 


Output overlaps in FNP 2,875. Aray> aren: Snel os ws vsentl/ Sovd. ; 
3 2 y) 7. 

Average length of DIA request queue 0.5 ra be a oe ates ng Te BO Prom muir oer DA 

ee ne measured « a ee: AH t$ VSvelly Bvsy. 

~ The sae 

Exhaust status BAo Th: ing Fro cov! no) Keef vP we} wi 
Software transfer timing error 
Pre-exhaust status 
Bell/quits 
Echo buffer overflows 


Parity errors 


Pp SS> Ble e Pores 


oOoooo o 


r e 
Avg. number of pending status events 0.6 Avo Jenazh of SEF) wa Tepes Se ie 


Software status queue overflows 0 TArngs Ave ef Flom Ma Aint Sarus Bvt Keer VF be Th 
Hardware status queue overflows 0 Ra . an 
Input buffer allocation failures Couthe T ailaate Butler, Oxhaui S Tres 


Ben (qu: is en AS yAc 
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channel _comm meters 


a.h006 
input output 
Messages transmitted 226 ,489 178 ,924 
Minimum message length 2 2 
Maximum message length 133 133 
Average message length Dsi9 29225 eg \oads On 
apf The vA 
| Lito tanowd By PE 
Frames dumped: — 413-/NFO vats hae 
Frames retransmitted: 4 
Receiver reset request: 0 
Transmitter reset: 0 
Frame check errors: 46 
Frame aborts received: 35 
Output overlaps in FNP 37,741 
Average length of DIA request queue 1.5 
Exhaust status 19 
Software transfer timing error 0 
Parity errors 0 


Avg. number of pending status events 1 
Software status queue overflows 0 
Hardware status queue overflows 0 
Input buffer allocation failures 0 
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channel comm meters 


a.h008 
Idle time 42.19% 
Input 

Blocks NAKed 2 
Transmission timeouts 0 
NAKs for DIA backlog 68 
All transmission suspended 0 
Blocks transmitted 4,812 
Records transmitted 43,204 

Average records per block 8. 
Duplicate input blocks 106 
Output reprocessing 0 

Blocks reprocessed 0 

input 

Messages transmitted 4,812 
Minimum message length 8 
Maximum message length 397 
Average message length *B 344.85 
Output overlaps in FNP L522 


Average length of DIA request queue 0.5 


Exhaust status 0 
Software transfer timing error 2 
Parity errors 0 


Avg. number of pending status events 0 
Software status queue overflows 0 
Hardware status queue overflows 0 
Input buffer allocation failures 0 


MCS Metering 


Output 
68 
8 
N/A 
0 
7,042 
69 
0.01 
output 
7,042 
8 
398 
8.09 
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channel _comm_meters -sum 


Lor Apuick SCan 


Total metering time 78:15:36 
Charo es Out 
cps cpsi  cpso iotxXsbepQqa err ABE name user 
120 No data. No data. 0 aE a.h000 Initializer 
0 No data. No data. 0 a a.h001 
120 0.00 £40.11 0 aE a.h002 Initializer 
120 9.00 0.02 Oa a.hd0d3 
Cow 0 No data. No data. it X Os a.h006 
Qt 0 No data. No data. io s 78 s a.h008 
yf ~O No data. No data. 0 s a.h009 
wn" 480 «1.17 «17.76 0 aE a.h010 Weber 
480 0.01 0.10 0 aE a.hOll Initializer 
480 0.09 3.70 0 aE a.h012 Initializer 
480 0.02 0.29 0 aE a.h013 Initializer 
480 0.04 2.24 O aE a.h014 Initializer 
480 0.01 £0.65 0 aE a.h015 Initializer 
O No data. No data. 0 s a.h0O16 
0 No data. No data. 0 s a.h017 
480 0.39 0.03 »K eQq 224 aE a.h0l8 Initializer Gck line 
480 0.18 2.06 0 a a.h019 
480 0.66 11.58 Q aE a.h020 Larmat 
480 0.00 0.12 0 a a.hd21 
480 0.14 9.32 0 aE a.h022 Initializer 
480 0.05 1.34 0 a a.h023 
0 No data. No data. iot P 130 s = a.hQ25 
480 0.04 0.84 0 aE a.h026 Initializer 
480 0.08 0.97 0 a a.h027 
480 0.01 0.45 0 aE a.h028 Initializer 
480 0.21 7.07 0 aE a.h029 Raich 
480 0.01 1.56 0a a.h030 
480 0.03 1.53 0 a a.h031 


: Invalid input messsage 

> Output message restransmitted 

: timeout waiting for acknowledge 
: pre-exhaust status 

exhaust status 

software transfer timing error 
bell /quit 

echo buffer overflow 

parity error 

software status queue overflow 
hardware status queue overflow 
input buffer allocation failure 
Asynchronous channel 
Synchronous channel 

Echoplex mode 


Hw P wo OU 0 OW bd Od ct OO 
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fot 


display_fnp_idle ~hishotan 


07/13/84 1545. P 


lest YyS2 meet. ¢nPn dle Ref 


display_fnp idle -sum 


FNP a idle time from 07/13/84 1545.2 to 1554.2: 81.3% 
Busiest sample interval: 

07/13/84 1546.2 to 1547.2: 76.8% idle WoRha [ 
Busiest single sample: 07/13/84 1554.2: 0.0% idle 


W-lo minvie tntervalS Qre VYAC4' 


you Com Relance [snes The Pree. Frye s 


7 ee Ye nove WV ac a4 module + OC he 


U-Ksradt se —Lache 


O° LE CGR rere | Oe avade ne ope COs VAC Ca cho. 


Fr & 
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MCS Debugging 


3 FNP Problems/Dumps 
] >scl>fnp_crash_notify.ec 
|] dump management 


| debug fnp 


FNP Problems/Dumps 
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debug fnp example 


— db _fnp 
red fnp.a.011084.1126 > \ 
No TTB oariabie “Terminal inFoRmalt or & aes [nDey (Le ap ( Calas 


domes bet donés tn dongs } dunt add cess of TLR. 
umd dir J domPS> glddumes changes “" o0ks , AMOS also Boes aif, 


—~what 
Dump in >udd>SysAdmin>Homan>fnp.a.011084.1126, version 6.54 Proe T4le = ney 
gd ‘es 2 7 
more No 
__why PEM piilidy Playpen wT does 17 (orvec?ly 


illegal opcode fault at 46355 (util|]6145) af e SeT- tay] 
utilities: tried to free space already free 


tllega/ oP tafe WAS thfealtoral 
To Ferce ed ¢ Rash, 
IT exoceled Kine mack 


fortune Con Froveed, add 085, dare Corl : 


— map 
sked 4540 09/23/82 “167 oe 
intp 776 ueys2 |< ind Fae VST Ages Some oF Ths B'SO. more Ars: 
ctrl 13400 10/15/82 
dia 17060 01/11/83 
melt 26342 12/01/82 
hsla -27250_-(07/07/83 
util 40210 _ 12/01/82 
crac 46740 09/23/82 
bse 47400 09/23/82 
hasp 54210 09/23/82 


x25tbs 56142 02/01/83 


meters 66112 09/23/82 
it 66304 09/29/83 


LLC ea ane SAS asf ww 


regs Valyes sf FW vee, stellt 

ic 046355 (util]6145) rasitectron CaerTer 

aq 137400 000040 _ 
ir 520077 (zero,carry,interrupt inhibit) tad: caTor ve4qi ster 
xl 077340 (init]11034) 


x2 004176 
x3 077000 (init|10474) 
er 777700 
et 776700 Mo Ural here 
{NO 
—abstat burcrer £Tetus looks AT TI's sa All Lp anes 


571 free KwP lol defautt Rupr S420 (33 eed REF. v3) 59) K 22 wees ~ Free Sfare 
12 small space 56 100) 1g Pskey 


LINE INPUT DIA OUTPUT TOTAL low RefFPRS CAKES Bei/e Qu, j 
ieee t1gnets 1 Wo Alans s 

a.h010 1 0 0 i bafy 

a.h015 1 0 9) 5 

a .hO21 1 9) 0 1 
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ASYac , Va vsun | pmowrt rnbeT fF vF ers 


O19 TYfFicar ovylar PoFAS Mel CeT- cay 


a.hl112 0 0 6} 3 
a.hll4 4 0 0 4 
a.hll5 1 0 0 1 
TOTAL - 8 0 3 11 


ae Jeet weal 

Go most (eC anT oc fal eniries y 10 

— print_trace -50 Winaicg 
{662566 op block at 53024 (bsc[3424), type = 060 (clrlcf) 
Sf? 662567 op block at 53027 (bsc|3427), type = 037 (retsub) 
Cieck 662567 op block at 54376 (hasp|166), type = 061 (tstlcf) 
Valu’ 662570 op block at 54427 (hasp|217), type = 033 (dumpin) 
intel. 662570 op block at 54430 (hasp|220), type = 056 (tstlcl) 
ha 662571 op block at 54370 (hasp|160), type = 072 (setimv) 
662572 op block at 54372 (hasp|162), type = 005 (dewlst) 

662572 hsla dew processor, tib 122562, list 54373 (hasp|163), len O1 Send dew Comm ad 


| 662575 hsla pew ib 122562, pew 211000 000460 ro HSlA, look en 
Lun J 62576 op block at 54374 (hasp|164), type = 036 (calsub) SIAL om op 
bt VA = 662577 hsla interrupt, 3wjt = 362004 (ch=7 dv=2 subch=10 mod=4)>C- 7/08 
To wee}:?¥ 662600 op block at 52476 (bsc|3076), type = Cirle (2 Tithe han) 
Line 662600 op block at 52501 (bsc|]3101), type = 060 (clricf) 461A aif ” 


662601 op block at 52504 (bsc|3104), type = 061 (tstlcf) 
662601 op block at 52510 (bsc|3110), type = 061 (tstlcf) 
662602 op block at 52514 (bsce]3114), type = 003 (wait) 
662602 hsla status, tib 122562, status 400000 404460 
662721 hsla interrupt, 3wjt = 363004 (ch= 
662722 hsla status, tib 123512, status 00 702060 
662723 istat: tib at 123512, t.cur = 16367 (ctri1|2767), status 000407 
662724 op block at 16413 (ctr1!3013), type = 004 (status) 

662724 op block at 16036 (ctr1|2436), type = 036 (calsub) 

662725 op block at 17034 (ctr1|3434), type = 005 (dcewlst) 


6639795 hela dArw nracreacanr trih 192519 list 17035 (fetrl! 32435) 


abe Soe NT OF prevrwvevsev=s. wt the g hee 1s aod \w eee] wor 


662726 hsla pew, tib 123512, pew 211400 000060 

662727 op block at 17036 (ctr1[3436), type = 006 (setime) 
662727 hsla interrupt, 3wjt = 363004 (ch=7 dv=2 subch=14 mod=4) 
662731 op block at 17040 (ctrl|3440), type = 003 (wait) 

662732 hsla status, tib 123512, status 420000 700060 

662732 istat: tib at 123512, t.cur = 17040 (ctr1|3440), status 000047 
662733 op block at 17044 (ctrl|{3444), type = 004 (status) 
662733 op block at 17050 (etr1[3450), type = 037 (retsub) 
662734 op block at 16040 (ctr1|2440), type = 052 (setcct) 

662735 op block at 16042 (ctrl1}|2442), type = 011 (clrflg) 
662735 op block at 16045 (ctr1|2445), type = 017 (sendin) 

662736 op block at 16046 (ctr1|2446), type = 076 (setfld) 


2 


662736 op block at 16051 (ctr1|2451), type = 014 (signal) pee) 

662740 new entry in dia i/o queue at 067176: opcode 113 (brkcon), line 14) 

662740 op block at 16053 (ctr1|2453), type = 012 (tstflg) ve é 

662741 op block at 16064 (ctr1|2464), type = 013 (dmpout) ines! YB C4an RB 

ccelay — SymBeliC or Can Ge Absolute r Br Salk fy, 
Guo for Trends hla am 

——explain .crldt;d .crldt Ke acre) 

",crldt* = date and time of binding eee a ee 


00640 000000 112155 200407 431126 09/29/83 1746.7 hfe Thu 
explain .crbdt;d .crbdt 
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".crbdt" = date and time of bootloading 

00644 000000 112346 660120 236056 01/04/84 1050.2 hfe Wed 
explain .crbuf;d .crbuf 

" crbuf" = starting address of buffer area 

00650 066476 

explain .crmem;d .crmem 

".crmem" = last location of memory 
00651 177777 

explain .crnbf;d .crnbf 

".crnbf" = number of buffers aire ih 


Coc dis flo y Com Compan + But FeaS 


00652 001073 ASke 
explain .criom;d .criom FfPe ae 
* criom" = start of iom table 3 yt = vr FeRS From Sia 


00653 004200 

explain .crnhs;d .crnhs 

".crnhs" = number of hsla’s configured 
00654 000002 

explain .crnls;d .crnls 

".crnls" = number of lisla’s configured 
00655 000000 

explain .crcon;d .crcon 

",crcon" = console enabled flag 

00656 060000 

explain .crmod;d .crmod 

".crmod" = starting address of module chain “ 
00657 004562 ~——weFt? Shan address oF ney Qubrer 
explain .crnxa;bufc .crnxa,* So CRnxn Contains 617800 

* crnxa™ = ptr to next avaliable buffer 

67300 oo0¥a0” ooo 000000 000000 000000 007000 007000 000000 7. ............ 


67310 000000 000 000000 000000 000000 000000 000000 000000 ................ 
a fr Aals Nv Boe oF wo hd § 


Zé 
67440 067540 000040 000000 000000 000000 000000 000000 000000 7*. ............ 
67450 | 000000 000000 000000 000000 000000 000000 000000 000000 ................ 
67470 | = 


eci me [ 


67540 000000 007240 000000 000000 000000 000000 000000 000000 ... ............ 
67550 000000 000000 000000 000000 000000 000000 000000 O00000 ................ 
67570 = 

explain .crtra;d .crtra 

",crtra™ = trace entry enable mask 

00661 317777 

explain .crtrb;d .crtrb 

",ertrb" = base address of trace table 

00662 174000 

explain .crtre;d .crtre 

".ertre" = next available location in trace table 

00663 177536 

explain .crreg;d .crreg 

".crreg" = disaster fault register storage location 

00664 040522 

explain .crttb;d .crttb 

"lerttb" = location of tib table 

00665 066316 
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explain .crtte;d .crtte 

"l.ertte" = location of end of tib table 

00666 066476 

explain .crdly;d .crdly 

" crdly" = head of delay table chain 

00667 067142 

explain .crver;d .crver 

" crver" = mcs version number, 4 chars 

00670 066056 065144 6.5d 

explain .crbrk;d .crbrk 

"/erbrk" = addr of breakpoint control table 

00672 000000 

explain .crtsw;d .crtsw 

".crtsw" = if non-zero, tracing will pases p fO 
um 


00673 000000 om TeQrons fea , ‘T vse 
explain ee .crnxs,* 40 Snall RFF rs no) chanel ee al 


".crnxs" = next free small block Clrarn feyvesT 
00674 066602 

66602 066674 000056 400112 000000 066616 000004 400112 000000 
66612 066616 000004 400112 000000 066642 000020 400112 000000 
66622 066642 000004 400112 000000 066642 000004 400112 000000 
66632 = 

explain .crnbs;d .crnbs 

".crnbs" = number of buffers devoted to small space 
00675 000014 

explain .crect;d .crect 

".crect" = address of first cect descriptor 

00676 067166 

explain .crskd;d .crskd 

".cerskd" = address of scheduler data block 

00677 006442 sked{1702 

explain .cretb;d .creth 

".cretb" = list of echo-negotiation bit tables 

00700 066660 

explain .crept;d .crept 

",crept" = address of cpu page table 

00701 004000 

explain .crpte;d .crpte 

".crpte" = address of variable cpu page table entry 
00702 004177 

explain .crtsz;d .crtsz 

".crtsz" = size of trace data buffer 

00703 004000 

explain .crmet;d .crmet 

".,crmet" = non-zero if metering enabled 

00704 900001 

explain .ecrtdt;d .crtdt 

".crtdt" = address of tib for t&d executive channel 
00705 133512 

explain .crbtm;d .crbtm 

".crbtm" = address of time meters for getbuf/frebuf 
00706 045276 wutilj5060 

explain .crnxe;bufe .crnxe,* -bf 

".crnxe" = next available space in extended memory 
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gu.12 
2 


135440 


136740 


137240 


137340 


137400 


137540 


137700 


140000 


171400 


172000 


172400 


173000 


173400 


136740 
137240 
137340 
137400 
137540 
137700 
140000 


140100 


172000 
172400 
173000 
173400 


000000 


000040 **. 
000040. 
000040 _°. 
000040 __.. 
000040 _°. 
000100 @.@ 
000040 °.. 


000040 ‘@. 


wh docewat 


000400 z... 
000400 z... 
000400 {... 
000400 {... 


000400 .... 


explain .crbpe;d .crbpe 

“.crbpe" = buffer paging window table entry 
00710 004176 

explain .crepr;d .crepr 

",crepr" = copyright notice 


4 91599 CLAIM NEATN 
00760 103117 120122 YOoVeV YVoVLY 


3 
00770 040111 116103 056040 061071 


051040 110056 

070061 040040 

dump /Rgp.a.011084 .1126 

No AIB available = 

line a.hll14 use TA OF 
d tib 

i SX 79124512 
124522 
124532 
124542 


a WNAY 


012207 207304 400002 
377352 000000 000000 
001431 310450 000000 
077400 000000 013463 
124552 000000 000000 000000 
124562 000000 000000 077570 124620 124660 
explain t.stat;flags t.stat—'*s ‘? 
sees tester” = holds current line status 
124512 012207 tsirts tsfdtr tsfrev tsfdsr 
explain t.flg;flags t.flg { 
"t.flg" = flag word pas °" red 
124513 207304 tfecpxstftbec tferec tflfec 
explain t.flg2;flags t.tig2 °‘*° ?/* 
"t.£1g2" = second word of flags 
124514 400002 tfpfnl tfdild 


015334 
000000 
015332 
000013 
000000 000000 


001116 
000000 
000000 
000000 


123740 
277002 
131740 
000000 
000000 


tsfcts 
nd 


tfquit 
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114340 000004 
000000 000001 
000000 000000 
000000 000000 
000000 000000 


tsied 


padfait net 


tflisn tffidpx 
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explain t.cur;d t. cur, kK ARloek Beats ovr 
"t.cur"™ = current address in control table 
124515 015334 etrl|1734 

explain t.line;d t.line 

"tc. line" = 10 bit line number 

124516 001116 

explain t.icp;d t.icp;bufe t.icp,* 

"t.icp" = first buffer in input chain 

124517 123740 
123740 134440 
123750 175075 
123760 075077 
123770 077155 


173077 
173165 
153153 
057057 


000074 
067157 
077057 
155153 


155077 
165075 
077077 
173077 


153055 
125167 
067077 
173173 


173157 
077165 
077077 
[33173 


000074 
177177 
073133 
177177 


177172 
177133 
176177 
133173 


134440 
134450 
134460 
134470 


142040 
157177 
077177 
077073 


157177 
177157 
157077 
176177 


177177 
073173 
073176 
177177 


177177 
077176 
057177 
137137 


142040 
142050 
142060 
142070 


114340 
073067 
155177 
153057 


000074 
133057 
177177 
073177 


135177 
157173 
147073 
155167 


073167 
157155 
177175 
177177 


177177 
135133 
177157 
173057 


177165 
133133 
177177 
077077 
114340 000000 
114350 135077 
114360 000000 
114370 = 
explain t.ilst;d t.ilst 

"t.ilst" = last buffer in input chain 
124520 114340 


Jent-da + 
be Pe ys Ge 


000021 
173177 
000000 


133133 
177000 
000000 


173065 
000000 
000000 


153177 
000000 
000000 


165077 
000000 
000000 


Irn 


avnlain +f 
Lop.a 


explain t. 
"t.icpl" = count of buffers in icp chain 
124521 000004 

explain t.icch;d t.icch 

"t.icch" = address of next input character 
124522 377352 

explain t.elnk;d t.elnk 

"t.elnk" = link to tib extension 

124523 000000 

explain t.rep;d t.rcep 

"t.rep" = replay chain pointer (share t.elnk) 
124523 000000 

explain t.ocp;d t.ocp;bufc t.ocp,* 

"t.ocp" = addr of output chain from cs 
124524 900000 

Invalid buffer address: 0 

explain t.ocur;d t.ocur 

"t.ocur" = addr of current output buffer 
124525 000000 

explain t.olst;d t.olst 

"t.olst® = addr of last buffer in output chain 
124526 000000 

explain t.occh;d t.occh 
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ePRlock 


157157 
155077 
173173 
155153 


165135 
177133 
177153 
177177 


177165 
135153 
157133 
153157 


125135 
000000 
000000 


057075 
075077 
157167 
173177 


177177 
055055 
177077 


077127 7 


176176 
157065 
157157 
057155 


155057 .... 


000000 
000000 


\ .<m?k- {0{?00/= 
}=7ou=Uw?u{um?=? 
=22/22727272?kk{ {ow 
?mmk{?{{[{//mk{. 


b par ae ee 
0....0;{.[?~.[-- 
?. iLoinn./. wk.? 
eo ~[{_..?W 


L* .<].jw...u.u-~ 
>7[/ofom] [[[]ke5 
M...8;.}.0..o0[00 
k/;.mw..{/??ko/m 


[{k.{5u?U]m/ 


ee ee © 6 + Be ae ow © 


ee er eB PF Fe Foe HH eH oO 
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"t.occh" = addr of next output character 

124527 277002 

explain t.ocnt;d t.ocnt 

"t.ocent™ = count of buffers in t.ocur 

124530 000000 

explain t.type;d t.type 

"t.type" = line type 

124531 000001 

explain t.time;d t.time 

"t.time” = time at which next timeout will occur 

124532 001431 310450 

explain t.reta;d t.reta 

"t.reta" = return address from calsub 

124534 000000 

explain t.dewa;d t.dcewa 

"t.dewa" = addr of dew list to ‘execute’ 

124535 015332 ectr1{1732 

explain t.dewl;d t.dewl 

"t.dewl" = length of dew list 

124536 9000000 

explain t.echo;d t.echo;d t.echo,* 40 

"t.echo" = echo buffer address 

124537 131740 

131740 377354 377354 000157 057155 133133 153177 173065 165077 
131750 125135 155057 135077 173177 177157 155135 133133 133135 
131760 153157 065155 177177 177147 073177 175177 157177 177157 
131770 133157 157153 057073 177155 167177 177173 057077 077153 
explain t.dep;d t.dcp 

"t.dep" = addr of message chain for cs 

124540 000000 
explain t.dlst;d t.dlst 
"t.dist" = last buffe 
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124541 000000 

explain t.ftse;d t.ftse 

"t.ftse" = first time slot entry in lsla table 
124542 077400 

d t.sfcm 

124542 077400 

explain t.bent;d t.bent 

"t.bent" = counting temporary 

124543 000000 

explain t.brkp;d t.brkp 

"t.brkp" = pointer to current break list 
124544 013463 
explain t.pos;d t.pos 
"t.pos" = current carriage position 

124545 000013 

explain t.ecch;d t.ecch 

"t.ecch" = address of current echo char (hsla only) 
124546 000000 

explain t.cntr;d t.cntr 

"t.cntr™® = counter for control tables 

124547 000000 

explain t.f1g3;flags t.f1g3 
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"t.f1g3" = third word of flags 

124550 000000 

explain t.dtp;d t.dtp 

"t.dtp" = pointer to delay table for this line 

124551 000000 

explain t.frme;d t.frmc 

"t.frmc" = framing chars (2 chars) 

124552 000000 

explain t.depl;d t.depl 

"t.depl" = number of buffers in dcp chain 

124553 000000 

explain t.scll;d t.scll 

"t.scll" = screenline length left, for echo neg. 

124554 000000 

explain t.snec;d t.snec 

"t.snec" = Echo negotiation sync ctr. 

124555 000000 

explain t.entp;d t.entp 

"t.entp" = Echo negotiation break table ptr 

124556 000000 

explain t.ifch;d t.ifch 

"t.ifch" = input flow control characters 

124557 000000 

explain t.ofch;d t.ofch 

"t.ofch" = output flow control characters 

124560 000000 

explain t.omet;d t.omct 

"t.omet" = output message count (for flow control) 

124561 000000 

explain t.itim;d t.itim 

"t.itim™ = time of last call to inproc (2 words) 

explain t.metr;d t.metr 

"t.metr" = address of metering area 

124564 077570 

explain t.abf0;d t.abf0 

"t.abf0" = absolute address of first permanent buffer 

124565 124620 

explain t.abfl;d t.abfl 

*t.abf1" = absolute address of first permanent buffer 

124566 124660 

explain sfem;d sfcm 

Symbol "sfcm" has no explanation. 

124400 002340 077472 077472 000012 077512 000204 105740 103340 
124410 000000 000000 000460 067200 000000 004374 000040 000040 
124420 000040 377347 O00000 000012 571626 000004 000000 700660 
124430 000000 700460 000000 700460 000000 900000 000000 000000 
124440 000000 000000 600000 700460 000000 000000 032000 700660 
124450 000000 000000 004000 700460 000000 000000 600000 700460 
124460 000000 000000 012000 700660 000000 000000 

explain sf.hem;d sf.hem 

"sf.hem" = addr of hwcm 

124400 002340 

explain sf.nxa;d sf.nxa 
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"sf.nxa" = addr of next available queue entry 


124401 077472 
explain sf.nxp;d sf.nxp 


"sf.nxp" = addr of next queue entry to process 


124402 077472 

explain sf.tly;d sf.tly 

"sf.tly" = tally of status queue 

124403 000012 

explain sf.tib;d sf.tib 

"sf.tib" = addr of tib for this line 
124404 077512 

explain sf.flg;flags sf.flg 

"sf.flg" = flag word 

124405 000204 sffdet sffcoi 

explain sf.ib0;d sf.ib0,* 40 -ch 

"sf.ib0" = pointer to input buffer 1 
105740 040377 373265 365277 325335 355257 
105750 377357 273173 377333 277376 377333 
105760 357277 273376 376377 257377 377153 
105770 376377 377377 333373 137137 377377 
explain sf.ibl;d sf.ibl,* 40 -ch 

"sf.ib1" = pointer to input buffer 2 
103340 040273 367377 377377 365377 365376 
103350 173157 155135 333133 333135 153357 
103360 273377 375377 357377 377157 133357 
103370 167377 377373 257277 277353 357257 
explain sf.ob0;bufe sf.ob0,* 

"sf.ob0" = pointer to output buffer 1 
Invalid buffer address: 0 

explain sf.obi;bufe sf.ob1,* 

"sf.ob1" = pointer to output buffer 2 
Invalid buffer address: 0 

explain sf.pcew;d sf.pew 

"sf.pew"™ = current pew 2nd word 

124412 000460 

explain sf.cct;d sf.cct 


335277 
255255 
377277 
277327 


376273 
265355 
157353 
355333 


"sf.cct" = cct addr for this line, if non-zero 


124413 067200 
explain sf.rct;d sf.ret 


"“sfi.ret™ = repeat count for status queue overflows 


124414 000000 
explain sf.hsl;d sf.hsl 


373377 
277377 
277273 
335377 


267333 
377377 
257273 
333353 


"sf.hsl" = address of hsla table entry for this line 


124415 004374 

explain sf.bsz;d sf.bsz 
"sf.bsz" = max buffer size 
124416 000040 

explain sf.fbs;d sf.fbs 


"sf.fbs" = buffer size to be used during frame input 


124417 000040 
explain sf.mms;d sf.mms 


"sf.mms" = maximum synchronous message size 


124420 000040 
explain sf.csz;d sf.csz 
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"sf.csz" = current asynchronous buffer size 

124420 000040 

explain sf.rms;d sf.rms 

"sf.rms" = remaining unallocated message length 

124421 377347 

explain sf.nic;d sf.nic 

"sf.nic" = char. address of next asynchronous input char 

124421 377347 

explain sf.noc;d sf.noc 

"sf.noc" = char address of next asynchronous output char 

124422 000000 

explain sf.cfg;d sf.cfg 

"sf.cfg" = 2 words for config pew 

124424 571626 000004 

explain sf.waq;d sf.waq 

"sf.waq" = wrap around queue, software status q 

124442 600000 700460 000000 000000 032000 700660 000000 000000 
124452 004000 700460 000000 000000 600000 700460 000000 000000 
124462 012000 700660 000000 000000 024000 700460 000000 000000 
124472 004000 700460 000000 000000 600000 700460 000000 000000 
124502 012000 700660 000000 000000 024000 700460 000000 000000 
explain sf.sta;d sf.sta 

"sf.sta" = hardware status q, sicw here 

124426 000000 700660 000000 700460 000000 700460 000000 000000 
124436 000000 000000 000000 000000 

d hwem 

02340 105747 460057 103340 460075 131754 470000 131754 450000 
02350 672000 124400 000000 CO00000 124426 420005 443026 010004 
explain h.ricO;d h.ricO 

"h.ricO" = primary receive icw 

02340 105747 460057 

explain h.ricl;d h.ricl 

"h.ricl" = alternate receive icw 

02342 103340 460075 

explain h.sic0O;d h.sicO 

"h.sicO" = primary send icw 

02344 131754 470000 

explain h.sicl;d h.sicl 

"h.sicl" = alternate send icw 

02346 131754 450000 

explain h.baw;d h.baw 

"h. baw" = base address word 

02350 672000 

explain h.sfem;d h.sfem 

"h.sfcm" = software comm. region address 

02351 124400 

explain h.mask;d h.mask 

"h.mask" = mask register 

02352 000000 000000 

explain h.aicw;d h.aicw 

"h.aicw" = active status icw 

02354 124426 420005 

explain h.cnfg;d h.cnfg 

"h.cnfg" = configuration status 
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02356 443026 010004 

explain m.dql;d m.dql 

"m.dql" = cumulative length of dia request queue 
124570 000000 000035 

explain m.dgqu;d m.dqu 

"m.dqu" = updates of m.dql 

124572 000000 000072 

explain m.nst;d m.nst 

"m.nst* = cumulative no. of pending status 
124574 000000 006023 

explain m.nsu;d m.nsu 

"m.nsu" = updates of m.nst 

124576 000000 006220 

explain m.over;d m.over 

"m.over" = output overlaps 

124600 000000 

explain m.par;d m.par 

"M.par" = parity errors 

124601 000000 

explain m.ssqo;d m.ssqo 

"m.ssqo" = software status queue overflows 
124602 000000 

explain m.hsqo;d m.hsqgo 

"m.hsqo" = hardware status queue overflows 
124603 000000 

explain m.inaf;d m.inaf 

"m.inaf" = input allocation failures 
124604 000000 

explain m.cql;d m.ecql 

"m.eql" = current length of dia request queue 
124605 000000 


ayvnladin m awhe A m awh 
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"m.exh" = exhaust status 
124606 000000 000000 
explain m.xte;d m.xte 

"m.xte" = software xte status 
124610 000000 

explain m.prex;d m.prex 
"m.prex" = pre-exhaust status 
124612 000000 000000 
explain m.ebof;d m.ebof 
"m.ebof" = echo buffer overflows 
124614 000000 000000 

explain m.quit;d m.quit 

"m. quit" = bell-quits 

124616 0600000 

q 
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debug fnp documentation 
Name: debug fnp, db _fnp 


The debug fnp command is a debugging aid intended to be used by FNP software 
developers and in FNP dump analysis. The command can be used to patch or 
dump memory in a running FNP, to examine a dump from a crashed FNP or a core 
image segment before it is loaded, to set breakpoints in a running FNP, 
symbolically display FNP control blocks, buffers, etc. 


Usage 


debug fnp {initial _command_line} 


where initial_command line is the first command(s) debug fnp is to execute. 
Once the initial command({s), if any, are completed, debug fnp reads command 
lines from user_input. Each line may contain multiple commands, seperated b 
semi-colons. If an error occurs in any command, the remainder of the 
commands on that line will not be executed. Any debug fnp command can be 
aborted by issuing a "Quit" followed by a Multics "program interrupt" 
command. 


Selecting debug fnp mode 


The debug fnp command can be setup to operate on either a running FNP, a dump 
segment, or a core image segment. When first invoked, the command is setup 
to examine the first configured FNP. It is possible to switch betweens 
dumps, core images, and running FNP’S at any time. With few exceptions, most 
debug fnp commands work the same regardless of whether a running fnp, a dump, 
or a core image is selected. 


To select a running FNP: 
fnp tag 
where "tag" is "a", “"b*, "e™, or "da". 
To select a core image: 
image path 
To select a dump: 
dump path 
where path is the Multics pathname of a segment containing the dump or the 
core image. Core image segments and dump segments have a different format, 
so these commands are not interchangeable. The pathnames on the dump and 


image commands can also be starnames, providing they match one and only one 
entry in the directory specified. 
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In most cases, it is not necessary to know the path name of the dump to be 
examined, as special commands are provided for selecting dumps. 


To list all the dumps currently in the dump directory: 
dumps 

The default dump direcotry is ">dumps" but this can be changed by: 
dump _ dir {path} 


where path is the pathname of the new dump directory. If "path" is omitted, 
the name of the current dump directory will be printed. 


To select the latest dump: 
last_dump 
The next earliest dump can be selected with: 
prev_dump 
The prev_dump command can be used repeatedly as long as there are more dumps. 
To select the next latest dump: 
next_dump 


The next_dump and prev_dump commands can be used to peruse any or all of the 
dumps in the dump directory, going in either direction. 


If dealing with a dump which contains multiple FNP’s, such a BOS fdump, the 
following command is used to select which FNP in the dump is examined: 


select_fnp tag 

where tag is "a", "b", "ce", or "d". 

To find out what FNP, dump, or core image is selected: 
what 


will print the fnp tag, or the pathname. 


Expressions 


Many of the following commands take numeric arguments such as addresses, 
lengths, etc. Any of these arguments can be expressed as a generalized FNP 
expression. Expressions can be arbitrarily complex, containing "(", ")", 
myn, mau ome" and "/" with their normal meanings and precedence. The symbol 
"|" is synnonomous with "+", as in modulejoffset. Indirection can be 
specified by ",*", following the address to indirect thru. Numeric constants 
are interpreted as octal, unless they are followed by a ".", in which case 
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they are decimal. The symbol “*" can be used for the current location 
counter, which is generally the last address used in a diaplay or patch 
command. Many common FNP symbols can also be used, including all fields in 
the system comm region, the hardware comm region, the software comm region, 
and the TIB. (Note: before TIB, hwcem, and sfem addresses can be used, the 
addresses of these control blocks must be established. See the "line" and 
"set" commands). A symbol may also be any opblock mnemmonic, the name of any 
FNP object module, or a machine instruction (specified by surrounding the 
instruction by apostrophes). In additon, user symbols can be defined. 
Examples of expressions: 


hsiaj 500 

t.icp,* 

*+30 

tib|14,*+10 

goto 

‘Ilda 0,2,b.0’ 

cax3 (apostrophe not needed if no operand) 


Displaying FNP memory 


To display the contents of FNP words: 


display address {length} {mode} 
d address {length} {mode} 


where "address" is the starting address, "length" is the number of words, and 
"mode" is the display mode. The symbol "*" will be set to the address 
sepcified. The following display modes can be used: 


octal, oct 
character, ch 


address, addr (in form module]|offset) 

clock, ck (4 FNP words as a Multics clock) 
instruction, inst (355 instruction format) 
opblock, op (pseudo opblock format) 

decimal, dec 

bit 


ebcdic, ebc 


If omitted, the length defaults to 1 unless "address" is a predefined FNP 
symbol, in which case the appropriate length for that symbol will be used. 
Similarly, if the mode is omitted, octal is used, unless "address" is a 
predefined FNP symbol in which case the mode appropriate for that symbol is 
used. 


To display a buffer: 


buffer {address} {mode} {-brief]-bf} 
buf {address} {mode} {-brief] -bf} 


where "address" is the address of the buffer, "mode" is the mode to display 
it in (see display command), and -brief means display only the first 2 words 
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of the buffer. If "address" is omitted, the next buffer pointer from the 
previous buffer displayed is used. If "mode" is ommitted, character mode is 
assumed. If -breif is not specified, the entrie buffer is displayed. the 
length is determined automatically by reading the buffer header. 


To display a buffer chain: 


buffer chain {address} {mode} {-brief|-bf} 
bufe {address} {mode} {-brief]|-bf} 


If the data being displayed is in the form of threaded control blocks, the 
following commands can be used: 


block {address} {-offset|-o offset} {-length|-1 length} 
blk {address} {-offset|-o offset} {(-length|-1 length} 


will display a control block at the address specified. The length of the 
block is specified with -length. The default is 8 words. The offset to the 
forward pointer in the block is specified with -offset. The default is 0. 
If the address is not specified, the next block in the chain will be 
displayed (using the forward pointer from the previous block). 


To display the entire chain of control blocks: 


block chain {address} {-offset]-o offset} {-length]-1 length} 
blke {address} {-offset|-o offset} {-length|-1 length} 


will display control blocks until one with.a zero forward pointer is 
encountered. 


@ 


where the arguments are the same as in the buffer command. This command will 
follow the threads in the buffer chain i 

If the data being displayed is a word of flags, the flags command can be used 
to show the setting of individual bits. 


flags address {type} 


where address is the the address of the word containing flags, and the type 
can be: 


t.stat tib status word 
tetle first tib flag word 
t.f1g2 second tib flag word 
sf.flg hsla sfem flags 


istat interpreter status word 
hs.1 first word of hsla hardware status 
hs.2 second word of hsla hardware status 


If {type} is ommitted, it is assumed to be the same as "address", which then 
must be one of the items in the above list. The flags are listed by name, as 
they appear in the macros.map355 source file. The explain command (see other 
commands) can be used to help with unfamiliar names. Occasionally, the value 
of a flag word is known (from a trace, for example), without knowing an 
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address of it. In this case, the following form can be used: 
flags =expression type 


where expression is any valid expression, and type is one of the types shown 
above. 


Patching FNP Memory 


To patch the contents of FNP memory: 
patch address argl ... {argn} 


where address is the starting address to patch, are the argi represent patch 
data. Each argi may be an expression representing the value to be stored in 
1 FNP word, or a character string in quotes (which may contain more that 1 
word of data). The total number of words patched cannot exceed 32. Before 
the patch is applied, the effects of the patch are displayed (old and new 
contents of every word) and the user is asked to verify that the patch is 
correct. The symbol "*" will be set to the address specified. Examples of 
patch commands: 


patch 43102 203456 -1 2 

patch .crver "3.1x" 

patch ctr1/1400 goto ctr1]1600 

patch hsla|{1541 ‘'tze 13’ cax3 ‘lda 0,2,b.1’ 
A shorthand form of this command is: 

=argl ... {argn} 
which is equivilent to: 


patch * argl ... {argn} 


Individual flag bits in words of flags can be manipulated with the following 
commands : 


set_flag flag symbol 


will set the bit associated with the flag symbol specified in the appropriate 
word. In a similiar way, 


clear flag flag symbol 
will clear an individual bit. Currently, these commands are not indivisible 
operations: this means if other flags bits in the word are dynamically 


changing, these command may change their value if they happen to have been 
changed between the time the word was read and when it was rewritten. 


Dump Analysys Commands 
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The following commands are only valid when using debug fnp on a dump. 
To find out the cause of a dump: 
why 
will print the type of fault which caused the crash, and if the crash was 
caused by a "die" opcode in the FNP, will interpret the reason for the 
crash. 
The command: 
regs 
will print the contents of all machine registers at the time of the fault. 


If the fault occured in a subroutine (as defined by the map355 ‘subr’ macro), 
information about the call is available with: 


call_trace address {-long|-1lg} 
This command will start at the address specified and perform a backwards 
trace of all subroutine calls. If -long is specified, the registers saved at 
each subroutine level will also be printed. This command can also be used on 
a running FNP, but the infromation is probably changing too fast for the 
command to be useful. 


FNP Trace Tables 


A running FNP or a dump will contain a trace tab 
”" xr 1 =A 


print _trace {start} 
print_trace {start} {count} 


where start indicates the starting trace message and count is the number of 
messages to display. If no arguments are given, the entire trace table is 
printed. If no count is given, the trace tables is displayed from the 
starting point specified to the end. If the start number is positive it is 
counted from the oldest message; if negative, it is counted from the most 
recent. For example: 


print_trace 200. 
Kip the 199 oldest entries and print the rest. 
print_trace -50. 
will print the 50 most recent messages. 
Printing the trace table of a running FNP is only meaningful if tracing has 


been suspended; otherwise the table is changing too fast to be interpreted. 
Tracing can be suspendend in a running FNP by: 
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stop_trace 
and restarted with: 
start_trace 


Tracing can also be stopped and started with some of the breakpoint commands 
explained below. 


Which modules in the FNP are traced is determined by the trace mask, kept in 
FNP memory. This mask may be examined or updated with: 


trace _mask {modules} 


If used with no arguments, trace_mask will display and interpret the current 
trace mask. If modules are given, they represent modules to be added to or 
deleted from the current mask. The module should be specified as ‘name’ or 
‘+name’ to set the tracing bit for the module; it should be ’-name’ or 
‘“name’ to turn off the corresponding bit. In addition, all and none may be 
specified. For example: 


trace_mask hsla “dia -lsla 


will turn on tracing for hsla_man and turn off traceing for dia_man and 
lsla_man. 


FNP Breakpoint facility 


The control table interpreter in the FNP allows breakpoints to be set in the 
interpreted control tables. A breakpoint will cause the line encountering it 
to stop execution in the interpreter until a command is given to restart it. 


o-* = 


Breakpoints are often a useful tool but a certain amount of care must be 
excercised in their use. The following points are important: 


1. Breakpoints can only be set in interpreted opblocks. They cannot be set 
at machine instructions. 


2. While at a break, the line is executing an opblock equivilent to: 
wait 0,0,0 
followed by no status blocks. This means that timers can runout unnoticed, 
status will be ignored, hangups can be missed, etc. For this reason, it may 


be difficult to restart a channel after a breakpoint. 


3. Breakpoints cannot be set at subroutine levels where waits would be 
illegal. 


4. Breakpoints cannot be set when a restart may execute a waitm opblock. 


5. Breakpoints cannot be set at a status opblock. 
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6. If a breakpoint is set at a wait opblock, it must be reset before the 
line is restarted. In addition, a breakpoint may not be set at a wait if any 
channels are currently waiting at that block. 


7. Control tables that use local internal variables (as opposed to variables 
in the TIB extension) cannot depend of these variables being preserved during 
the break unless other channels that may use the same control tables are not 
running. 


8. No notice is given when a channel encounters a breakpoint. The 
list_break command will list all breakpoints and show what channels are 
stopped at each one. - 


To set a breakpoint: 


set_break address -line- {-stop_trace} 
sb address -line- {-stop_trace} 


will set a breakpoint at the address specified. If a tty channel is given, 
the breakpoint will apply to that line only. Any other channel encountering 
the breakpoint will continue execution. If -stop_trace is specified, the FNP 
will automatically suspend tracing if any channel stops at that breakpoint. 


To reset a break: 
reset_break address 


reset_break -all 
rb address 


rb -all 
will reset a break at the address specified. Any lines stopped at the break 
are not automatically restarted. If -all is specified, all breaks will be 


AIVe Gh LUMA LICeaitak fF 


To start a channel stopped at a breakpoint, 


start line {address} {-reset} {-start_trace} 
start -all 

sr line {address} {-reset} {-start_trace} 

sr -all 


will restart the line specified. If an address is given, the line will be 
restarted at the address given, instead of where it was stopped. If -reset 
is specified, the break will be reset before the line is started. If 
-start_trace is specified, tracing will resume as the line is restarted. If 
-all is specified, all lines at breakpoints at the time the command is issued 
will be restarted. 


To list fnp breakpoints: 


list_break 
ib 
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will list all FNP breakpoints and the channels stopped at each. 


Peformance Analysis Commands 


The FNP software periodically samples the instruction counter to determine 
whether the FNP is running or idling. This meter can be displayed with the 
fnp_idle command, as follows: 


idle time {-reset|-rs} 


will print the percent of time the FNP has been idling since bootload, or the 
last time the command was invoked with the -reset control argument. 


The sampling interval used by the FNP for metering this data can be printed or 
set with the following command: 


sample time {new_time} 


where new_time, if specified, is the new sampling interval in milliseconds. 
The argument must be between 1 and 1000. If no argument is given, the current 
sampling interval is printed. The default sampling time when the FNP is 
booted is 50 milliseconds. 


More detailed information on FNP usage can be collected by configuring the 
module ‘ic sampler’ in the FNP core image. This module will periodically 
sample the instruction counter (at the rate set by the sample time command) 
and add i to a bucket which represents a small range (typically 16) of FNP 
addresses. With this data it can be determined with some precision where the 
FNP is spending its time when it is running. 


This instruction counter sampling feature is controlled by the ic_sample 
command, whih is only accepted if the ic_sampler module is configured in the 
FNP. The following options of the command are used to control ic sampling: 


ic_sample start 


starts the ic sampling feature. Sampling is normally disabled when the FNP is 
booted. 


ic_sample stop 

stops ic_sampling. 
ic_sample reset 

zeroes all the sampling buckets. 

The following options are used to display the information collected: 
ic_sample module 

prints a table showing each module in the core image and what percentage of 


samples collected occur in that module. 
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ic_sample histogram|hist {fraction} 


prints a histogram showing each bucket address that has data, and the percent 
of non-idle time that bucket represents. The fraction argument, if specified 
must be a floating point number between 0.0 and 1.0. If this option is used, 
the histogram will only contain the most frequently used buckets. Enough 
buckets will be printed so that fraction specified of the total data collected 
will be printed. For example, if the fraction is .9, 10% of the data 
collected will not be display by discarding infrequently referrenced buckets. 
This option is useful in deleting "noise" from the histogram. 


Other commands 
To select a specfic tty line: 
line {line} 


will locate the TIB, software comm region, and hardware comm region of the 
line specified. Once these addresses are set, fields in these control blocks 
can be referenced by name in any expression in other commands. The line can 
be specified either in Multics form (a.h012) or as an FNP line number 

(1014). If no line is specified, the name of the current line is printed. 

If the line selected is not on the current FNP, the proper FNP will be 
selected automatically. 


To print a summary of FNP buffer usage: 


buffer_status {-brief|-bf} 
bstat {-brief|-bf} 


a table é line and how much buffer space in the FNP it 
ng. If -brief is used, only summary information is printed. 


To set a symbol: 

set symbol value 
where symbol is '*', ‘tib’, ‘'hwem’, ‘sfem’, or any user defined symbol. 
Setting control block addresses (tib, hwem, sfcm) is more easily done with 
the line command, but can be manually done with the set command in case 
internal FNP tables have been damaged. Note that setting any of these 
control block addresses has no effect on the current value of other control 
blocks. Setting "*" is also done by any dump or patch command. Once set, a 
symbol may be used in any expression in any other command. 
To display a list of modules in the core image: 

map 


will display a list of modules and their addresses. 


To interpret an FNP address: 
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convert_address {addressl} ... {addressn} 
eva {addressl} ... {addressn} 


will convert the address to any other meaningful form that can be derived. 
For example, octal values will be converted to moduleloffset, and vice 


versa. 


To find the explaination of any FNP symbol (usally the output of a flags or 
convert_address command): 


explain syml {sym2} ... {symn} 


where symi are symbols to be explained. This command will print the comment 
form the line in macros.map355 that defined the symbol. 


To execute any Multics command: 

e Command Line 
will pass ‘Command Line’ to the command processer. 
To exit from debug fnp, 


quit 
q 
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uw Multics Problems/Dumps 
] tty_analyze 
] tty_dump 


[| trace_mcs 
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tty_dump 


LCTE at 13100, channel c.h212, devx 257 

channel type: tty (0) 

flags: in_use initialized 

physical channel devx 257, major channel devx 165, subchannel 72 
input_words 16, output_words 0 

data base at 71124 


WICB at 71124, channel c.h212, devx 257 

line type = ASCII, baud rate = 2400 

flags: listen,dialed,send_output,tcb_initialized,breakall 

hevent = 000464004602 407777000311, event = 007777000001 400000000002 
fblock = 201512, lblock = 201512, fchar = 0 

at line 0, column 0, white_col = 0 

0 read-ahead messages 

write first = 0, write_last = 0 

maximum buffer size = 16, buffer pad = 0 


line delimiter = " 


1" 


TCB at 55010 

terminal type = , old type = 0 

modes: rawi,rawo,fulldpx,ctl_char,breakall,can_type=overstrike 
flags: uproc_attached 

shift state = 00 (none) 11 = 0, pl =0 

answerback id = none 

erase #, kill @, frame_begin \000, frame_end \000 

input message size 0 characters 

input_translation 0 

output_translation 0 

input_conversion 0 

output_conversion 0 

special 0 

delay 0 

read 

201512 size = 16, tally = 49, flags: 

000000000061 123145164164 151156147040 124145155160 ...1Setting Temp 
157162141162 171040160157 151156164145 162163040146 orary pointers f 
162157155040 067063174062 064060056015 012015012141 rom 73|240..... a 
172155072040 040000000000 000000000000 000000000000 zm: .............. 
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Loaical Clan nel wer EaThy tty_dump 

LCTE at 10000, channel c.h0O16, devx 175 

channel type: x25 (11) 

flags: in_use initialized 

physical channel devx 175, major channel devx 165, subchannel 10 

input_words 0, output_words 0 

data base at 127752 

X.25 devx 175, 32 1c, 33 sc, ACTIVE flags: started send_output no_d 
packet_threshold=129 address=56 


LCTE at 41200, channel c.h016.001, devx 1021 

channel type: tty (0) 

flags: in_use initialized 

physical channel devx 1021, major channel devx 175, subchannel 1 
input_words 0, output_words 0 

data base at 131350 


WICB at 131350, channel ¢c.h016.001, devx 1021 

line type = ASCII, baud rate = 4800 

flags: listen,dialed,send_output,qenable,tcb_ initialized, hndlquit,count_lines 
hevent = 000464013026 407777000721, event = 007777000001 400000000001 

process blocked on input 

fblock = 0, lblock = 0, fchar = 0 

at line 7, column 0, white_col = 0 

Q read-ahead messages 

write_first = 0, write_last = 0 

maximum buffer size = 16, buffer pad = 5 


line delimiter = " 


Li 


TCB at 150604 

terminal type = VIP7205, old type = 7 

modes: can,esc,erkl,1lfecho,hndlquit,echoplex,polite,scroll,can_type=replace 
flags: uproc_attached 

shift state = 00 (none) 11 = 80, pl = 23 
answerback id = 3106 

erase #, kill @, frame_begin \000, frame end \000 
input message size 0 characters 

input_translation 0 

output _translation 0 

input_conversion 60 

output_conversion 170 

special 344 

delay 0 
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Oyun? 
tty_analyze USAS MUITICS SYS7 Cm U 


Me. piypober oI 


F : t YSes 
Begin analysis of ERF 66 ® € ene Dur Pp. 
TA 
Header Values: = ae: rust wat hy, 
bleft 6366, free 61212 "e. is pon Le cysten 
© 
CfASHCS vaveling mcS$ 


Physical channel c.h016, 4800 baud, devx 175, pcb 65460, Icte 10000, line type X25LAP 
flags: listen dialed send_output sync_line 


multiplexer type: x25 
X.25 devx 175, 32 lec, 33 sc, ACTIVE flags: started send_output no_d 
packet_threshold=129 address=56 
X.25 SC 1 c.h016.001 devx 1021: DIALED output_ready wru echoplex hndlquit polite lfech 
LC 16: state=p41(FLOW CONTROL READY) ,max_packet_size=128 ,window used=0/2 
iti baud=4800 
address=31063050005411 


Subchannel: ¢c.h016.001, devx 1021 

wteb at 131350 

flags: listen,dialed,send_output,qenable,hndlquit,count_lines,scroll 
blocked for input 


Physical channel ¢c.h212, 2400 baud, devx 257, pcb 66300, Icte 13100, line type ASCII 
flags: listen dialed send_output 

wteb at 71124 

flags: listen,dialed,send_output,breakall 

Read chain trace 

FBLOCK 

201512 size = 16, tally = 49, flags: 

000000000061 123145164164 151156147040 124145155160 157162141162 171040160157 15115616 
162157155040 067063174062 064060056015 012015012141 172155072040 040000000000 00000000 


Begin free chain trace 
61212 (2 words) 

61474 (16 words) 

62016 (6 words) 

62122 (2 words) 


202732 (140 words) 
203312 (10466 words) 


Begin unthreaded space check 
154702 (40 words) 
157276 (14402 words) 
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—\ DD 
QiMGe VL Rati nd cefull LA y PY 6 uP 


ent ts 
trace mes ts 1oo— werd 
r 08:22 0.199 94 


trace_mcs modes all 

New MCS trace modes: on, *default,read,write,data,control,modes,interrupt, 
init_mpx,start_mpx,stop_mpx,space_man 

r 08:23 0.199 89 


trace mcs channel ** -on 
r 08:24 0.435 91 


int Per ats OUY UeEnTS 

trace_mecs print 

08:24:55.331876 a.h214: int: proc accept_input 024130024130000007604103 
08:24:55.334231 a.h214: 16 words at 024130; 7 chars; flags: 
08:24:55.336228 a.h214: 0: 000000000007 003144020000 ..... Ciesi 
08:24:55.337438 -h214: 8: 010161215000 000000000000 .q...... 
08:24:55 .339879 .h214.001: int: proc accept_input 024130024130000002404103 
08:24:55.342078 -h214.001: 16 words at 024130; 2 chars; flags: break 
08:24:55.345253 .h214.001: 8: 010161215000 O0CO00000000 .q...... 
08:24:55.348781 a.h214: write: 216|41214: 6 bytes 

08:24:55.349907 -h214: 16 words at 041214; 6 chars; flags: break 
08:24:55.353048 -h214: 8: 240412000000 000000000000 ........ 
08:24:55.390663 -h214.001: control: reset_more 77777|1 

08:24:55.398741 a.h214.001: write: 216|24130: 19 bytes 

08:24:55 .400093 -h214.001: 16 words at 024130; 19 chars; flags: break 
08:24:55 .403383 -h214.001: 8: 072062064040 060056063071 :24 0.39 
08:24:55.404609 -h214.001: 16: 060040070015 012015012000 O 8..... 
08:24:55.408170 a.h214.001: int: queued send_output 000000000000000000000000 
08:24:55.411969 -h214.001: int: proc queued send_output 000000000000000000000 
08:24:55.423650 a.h214: int: proc send_output 000000000000000000000000 
08:24:55.426293 -h214: write: 216|24130: 24 bytes 

08:24:55.427510 -8214: 16 words at 024130; 24 chars; flags: break 
08:24:55.430770 a.h214: 8: 242162240060 270072262264 .r.0.:.. 
08:24:55.431998 -h214: 16: 240060056063 071060240270 .0.390.. 
08:24:55.433199 -h214: 24: 215012215412 000000000000 ........ 
08:24:55.629519 -h214: int: proc accept_input 024130024130000005604103 
08:24:55 .631780 .h214: 16 words at 024130; 5 chars; flags: 
08:24:55.633764 a.h214: 0: 000000000005 003206020000 ........ 
08:24:55.634967 -h214: 8: 041000000000 000000000000 !....... 
08:24:55.645811 -h214: int: proc send_output 000000006000000000000000 
08:24:55.786612 -h214: int: proc accept_input 024130024130000005604103 
08:24:55.788824 -h214: 16 words at 024130; 5 chars; flags: 
08:24:55.790779 -h214: 0: 000000000005 003250020000 ........ 
08:24:55.791978 h214: 8: 101000000000 000000000000 A....... 
08:24:55.969268 .n027: int: proc accept_input 024130024130000011404103 
08:24:55 .971547 -h027: 16 words at 024130; 9 chars; flags: 
08:24:55.973504 a.h027: 0: 000000000011 156145167137 ....new_ 
08:24:55.974704 a.h027: 8: 160162157143 012000000000 proc.... 
08:24:55.987471 a.h027: control: set_required_access_class 366|5160 
08:24:56 .002503 .n027: write: 216]24130: 60 bytes etc. 
08:24:56.003797 -h027: 16 words at 024130; 60 chars; flags: 
08:24:56.007063 ~hO027: 8: 040144151163 143157156156 disconn 
08:24:56 .008293 -hO27: 16: 145143164145 144040160162 ected pr 
08:24:56.009492 -hO27: 24: 157143145163 163040167151 ocess wi 


oP h Po MPP PW PHM MP PH WH MH HM MW MHP MP MW MH WM PW PP PW PP OH O HM 
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.010691 
.011892 
.013123 
.014348 
015472 
.018778 
. 020008 
.059137 
. 169153 
.170605 
.172639 
.173865 
.175127 
. 176354 
177579 
.178779 
.179977 
. 181180 
. 182305 
. 238164 
823444 
. 826460 
. 363862 
. 366380 
- 368450 
. 369678 
. 370917 
.372126 
374735 
376945 
. 380116 
. 381505 
. 382702 
. 386288 
- 387422 
. 390562 
462541 
>58.533918 
r 08: 25 0.929 89 


MCS Debugging 


PPP AA PHP APM HAH MW HAMA HPA MHA HAA AM HPA MH HH MH MH HHH HP PH H 


h027: 
h027: 
-h027: 
-h027: 
-h027: 
-h027: 
~h027: 
-n027: 
.hO00: 
.-hoo0o: 
-hoo0: 
nooo: 
.-ho0o0: 
.h000: 
-hooo: 
-hdoo: 
.-hdoo0: 
-ho0o0o: 
hooo: 
-hooo: 
.h027: 
.h027: 
-hoddé: 
-h006: 
.h006: 
ho0o6: 
.-hood6: 
-hode: 
-h006 
.h006 
.ho006. 
-hdood6. 
.h006 
.h006: 
.h006: 
hoo6: 
.h006: 
.h027: 


32: 154154040142 145040143157 11 be co 

40: 156156145143 164145144040 nnected 

48: 164157040164 150151163040 to this 

56: 164145162155 151156141154 terminal 

16 words at 041214; 18 chars; flags: break 

8: 145162040156 145167137160 er new_p 

16: 162157143056 015012000000 roc..... 
int: proc send_output 000000000000000000000000 
write: 216|24130: 60 bytes etc. 

16 words at 024130; 60 chars; flags: 

0: 041214000074 040060070062 !..< 082 
8: 064040040141 1630040040 4 as 

16: 103117116116 105103124040 CONNECT 

24: 126111120067 062060065040 VIP7205 

32: 040156157156 145040141056 none a. 

40: 150060062067 040115157162 h027 Mor 

48: 145154154157 056101111130 ello.AIxX 

56: 137101124015 012000000000 AT..... 

16 words at 041214; 21 chars; flags: break 
int: proc send_output 000000000000000000000000 
check modes: 230/1460 
set_mor?s: 230[{1460 
int: proc accept_input 024130024130000025604103 

16 words at 024130; 21 chars; flags: 

0: 000000000025 003106020000 ..... E.G 

8: 346164162141 143145137155 .trace_m 
16: 143163040160 162151156164 cs print 
24: 015000000000 S00c0CO0cOeCcee ........ 


.001: int: proc accept_input 024130024130000020404103 
.0O01: 16 words at 024130; 16 chars; flags: break 


001: 8: 145137155143 163040160162 e mcs pr 
in 


001: 16: 151156164012 162151156164 int.rint 


.001: 24: 015000000000 000000000000 ........ 


write: 216|41214: 6 bytes 

16 words at 041214; 6 chars; flags: break 

8: 216412000000 000000000000 ........ 
int: proc send_output 000000000000000000000000 
control: copy_meters 77777|1 
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10 March 82: trace_mes 


Function: Controls the MCS tracing facility and prints MCS trace table 
entries. 


Syntax: trace_mcs print {channel_name(s)} {-control_arguments} 
trace mcs reset 
trace_mcs modes {new_modes} {-control_arguments} 
trace_mcs channel {channel_name(s)} {-control_arguments} 
trace_mcs table size {new_table_ size} {-control_arguments} 


List of keywords: 

print, pr, p 
Prints entries from the trace table. 

reset, rs 
Resets MCS tracing: sets global modes to off,*default,none, sets the 
trace table size to zero, and turns off both channel tracing flags 
for all channels. No additional arguments are allowed. 

modes 
Prints the current global tracing modes, or changes the specified 
modes if a new_modes argument is present. See "List of modes", below. 


channel, chn 
Prints or changes the tracing flags for a single channel or group of 
channels. At least one of printing or changing must be specified, and 
at least one channel_name must be specified. 

table_size, ts 
Changes the size of the MCS trace table. The table size may only be 
changed when tracing is disabled, and if a trace table exists, the 
size must be first changed to zero and then to the new value in order 
to change the size to a different nonzero value. If no new table size 
is supplied, the current table size is printed. 


Arguments: 

channel name(s) 
Up to 20 different channel names may be specified. The channel names 
may be starnames, and all channels which match any of the supplied 
names is selected for the operation. 

new_modes 
Is the new mode string containing the global MCS tracing modes to be 
changed. See "List of modes", below. 

table size 
Is a decimal integer specifying the number of entries’ in the MCS 
trace table. Each entry occupies 16 words in tty_buf. The program 
queries if the new trace table size will occupy more than 50 percent 
of the free space in tty_buf, to guard against errors. 


Control arguments (all functions): 
-erf NNN 
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Takes the MCS trace table from the FDUMP for ERF NNN. If this 
argument is specified, no parameters (modes, channel flags, table 
size) may be changed, although they can be printed. 


Control arguments (print): 

-reset, -rs 
Resets the last trace entry indicator in trace_mcs. Normally, only 
those entries which have been added to the trace table since the last 
time entries were printed are printed. If -reset is specified, the 
next use of trace_mecs will print all the trace table entries. 

-all, -a 
Prints all trace table entries, but without resetting or changing the 
last entry indicator. 

-last NNN, -1lt NNN 
Prints the last NNN entries in the trace table, without resetting or 
changing the last entry indicator. 

-reverse, -rev 
Prints the entries in reverse order. This can only be specified if -all 
or -last is also specified. 

{-channel} XXX, {-chn} XXX 
Selects a channel or group of channels for printing. This control 
argument need not be supplied before the channel name, and is 
provided only for compatibility. 


Control argumentds (channel): 

-print, -pr 
Causes the state of the channel trace flags for the selected channels 
to be printed. If -on or -off is also specified, both the previous 
and new states are printed. 

-on 
Turns on the "trace" flag for the channel(s). If this flag is 
different from the "default" global mode, and the force flag is not 
also set, the channel is traced. If the force flag is set, the 
channel is traced regardless of the state of the "default" mode. 

-off 
Turns off the "trace" flag for the channel(s). Only one of -on and 
-off may be specified. 

-force, -fe 
Sets the "force" flag for the channel. If the force flag is set, the 
channel is traced or not depending only on the state of its "trace" 
fag, and not on the "default" mode. If -force is specified, one of 
-on or -off must also be specified. 


Control arguments (modes): 

-brief, -bf 
Suppresses the printing of the new mdes after the change is applied. 
Normally, the modes now in effect are printed. 

-long, -lg 
Prints the new mode string after the changes are applied (Defauit). 
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List of modes: 

on 
Whether tracing is enabled at all. The "on" mode may also be 
represented as "“off", and "“*on" as "off". 

default 
Whether channels are traced by default. Normally, this is off, 
meaning that only channels whose trace flag is set are traced. 

all 
May only be specified as "all", not "*all". This mode is a shorthand 
for setting all the remaining modes (except "none"), used to turn on 
tracing for all MCS events. 

none 
May only be specified as "none", and not as "“none". This mode is 
shorthand for resetting all the remaining modes. It is usually used 
in combination with some other mode or modes, to trace only those 
specific operations. 


read 

Whether channel _manager$read operations are traced. 
write 

Whether channel manager$write operations are traced. 
data 


Whether the data in read and write operations is to be recorded in 
the trace table, as well as the events themselves. 

control 
Whether channel _manager$control operations are traced. 

modes 
Whether channel _manager$check modes, get_modes, and set_modes 
operations are traced. 


interrupt 

Whether channel _managerSinterrupt, interrupt_later, and 

queued interrupt operations are to be traced. 
init_mpx 

Whether to trace priv_channel_manager$init_multiplexer operations. 
start_mpx 

Whether to trace priv_channel_ manager$start_multiplexer operations. 
stop_mpx 

Whether to trace priv_channel_ manager$stop_ multiplexer operations. 
space man 

Whether to trace calls to tty_space man requesting non-buffer type 

space. (Apparently not implemented) 


Access required: 

Access to phcs_ is required to print the trace table of the running 
system. Access to the FDUMP is required to access the trace table in an 
FDUMP. Access to hphcs_ is required to change any parameters for the 
running system. 


Notes: 
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The MCS trace table is kept in a circular array, with old entries being 
overwritten by new ones. Each entry contains the time, the device index 
of the associated channel, and a short string identifying the operation. 
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a Typical Problems 
] FNP load fails 
|] FNP Crashes 
| FNP Crashes Repeatedly 
] Multiplexer won’t load 
[| Channel won't dial up 
| Channel dials up but no I[/0 
] Frequent quit signals 


] User dials into wrong process 
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dn355_data.inel.pl1 segment 
entry modified: 06/21/85 1919.3 


a Sa pene ae Are A A nnn tn Anne ent sna ne et ni APA SERGIO AREA ne Sr 


/* 
[* 


*/ 
/* 


/* 


BEGIN dn355_data.inel.pl1 */ 
Date Last Modified and Reason 


Created 07/25/74 by R. B. Snyder for new ttydim. 


in: >ldd>include contents modified; 


Modified 06/23/77 by J. Stern to add channel_work_reqd and cwork_count 
Modified 08/14/78 by Robert Coren to remove devx_tab and invent PCBs 


Modified 79 May 14 by Art Beattie to add fnp_mem_size 


Modified December 1979 by Robert Coren to add FNP queue lock 
Modified January 1980 by Larry Johnson to increase max number of FNPs to 8 


Modified 02/12/80 by Robert Coren to add dew_list_array ptr 
Modified 03/06/80 by Robert Coren to add some metering info 


Modified 12/10/80 by Robert Coren to add get_meters_waiting flag 
Modified 83-12-16 BIM to use a chanid instead of iom/channel fb’s. 


Modified 1984-07-26 BIM for paged iom. 


LOCKING RULES: A fnp is locked by its LCTZ unless its LCTE is uninitialized. 


In that case, the configuration_lock must be held. 


4£ tty_lock$lock_lete returns io_no_permission, then the caller must 
lockS$lock_fast the configuration lock and retry the LCTE lock. If 
the lete is now initlalized, too bad. Otherwise, the config lock protects. 


Gonfiguration locking is interesting to init_multiplexer and 
all of fnp t&d and reconfiguration. The guts of the multiplexer 


pay no attention to it. Thus, if the LCTE can be locked, it 
locked before changing the io manager_assigned flag. */ 


format: style4,delnl,insnl,*ifthendo */ 


MUST be 


dcl max_no_355s fixed bin int static init (8) options (constant); 


del 


dcl 
del 


dcl 


*.inel 


/* 
dn355_data$ external fixed bin; 


infop pointer; 
fnpp ptr; 


1 datanet_info aligned based (infop), 

2 configuration_lock aligned, 
3 pid bit (36) aligned, 
3 event bit (36) aligned, 
3 flags aligned, 

4 notify sw bit (1) unaligned, 

4 pad bit (35) aligned, 
no_of_355s fixed bin, [* 
trace bit (1) aligned, [* 
debug_stop bit (1) aligned, {* 
pad (2) bit (36) aligned, {* 
per_datanet (max_no_355s) aligned Like fnp_info; {* 


Nw NHM NY NY 


dn355_data.inel.pll 


max no of 355s we can handle (arbitrary) */ 


no. of FNP’s */ 

watch events on console */ 

erash on errors */ 

to get alignment for dump reading */ 
data per datanet */ 


11/09/84 


0855.8 


Page 


1 


del 1 fnp_info aligned based (fnpp), /* structure for each FNP */ 


2 mbx_pt pointer, /* pointer to mailbox NULL if not in config */ 
2 peb_array_ptr pointer, /* pointer to array of physical channel blocks */ 
2 dew_list_array_ptr pointer, /* pointer to array of space reserved for output DCW lists */ 
2 no_of_channels fixed bin, /* number of channels on this FNP */ 
2 fnp_id, 
3 fnp_tag char (1) unaligned, /* letter identifying FNP */ 
3 fnp_number fixed bin (9) unsigned unaligned, /* sequence number of FNP */ 


3 pade bit (18) unaligned, 


2 io_chanid char (8) aligned, 
2 Lo _manager_chx fixed bin (35), /* devx for DIA on Lom */ 
2 lsla_idx (0:5) fixed bin aligned, /* index into PCB array for lsla lines */ 
2 hsla_idx (0:2) fixed bin aligned, /* index into PCB array for hsla lines */ 
2 count fixed bin, /* number of items in delay queue */ 
2 cur_ptr fixed bin, /* offset in tty_buf of next delay queue element */ 
2 last_ptxr flxed bin, {* offset in tty_buf of last delay queue element */ 
2 bleft_355 fixed bin, /* number of free buffers in this 355 */ 
2 flags, 
3 work_reqd bit (1) unaligned, /* mailbox messages queued up */ 
3 bootloading bit (1) unaligned, /* currently being bootloaded */ 
3 running bit (1) unaligned, /* this FNP is running */ 
3 wired bit (1) unaligned, /* bootload buffer is wired */ 
3 dump_patch_in_progress bit (1) unaligned, /* a dump or patch order is in progress */ 
3 level 3 pending bit (1) unaligned, /* level 3 interrupt pending */ 
3 level_7?_pending bit (1) unaligned, /* level 7 interrupt pending */ 
3 dump_patch_disabled bit (1) unaligned, /* dump & patch orders disabled because of timeout */ 
3 t_and_d_in_progress bit (1) unaligned, /* T & D using FNP */ 
3 t_and_d_lev_3_ occurred bit (1) unaligned, /* A level 3 occurred */ 
3 t_and_d_lev_?_occurred bit (1) unaligned, 
3 t_and_d_notify_requested bit (1) unaligned, 
3 t_and_d_assigned bit (1) unaligned, /* AS has given fnp to process */ 
3 get_meters_waiting bit (1) unaligned, /* waiting for meter copy to complete */ 
3 padb bit (22) unaligned, 
2 lete ptr ptr, /* pointer to this FNP’s LCT entry */ 
2 astep ptr, /* pointer to aste of wired bootload buffer */ 
2 boot_ev_chan fixed bin (71), /* event channel over which to signal bootload completion */ 
2 boot_process id bit (36), /* process that initiated bootload */ 
2 version char (4), /* version id of core image */ 
2 fnp_mem_size fixed bin (18) unsigned, /* memory size of this FNP in 18-bit words */ 
2 queue_lock bit (36) aligned, /* lock for interrupt queue */ 
2 dump_patch_lock bit (36), {* lock for fnp_dump or _patch operation */ 
2 q_entries_made fixed bin (35), /* count of delay queue entries made */ 
2 input_reject_count fixed bin, /* number of times input rejected */ 
2 processed_from_q fixed bin (35), /* number of interrupts processed from queue */ 
2 fnp_channel_locked fixed bin (35), /* number of times dn355 found per-FNP lock locked */ 
2 input_data_transactions fixed bin (35), /* number of mailbox transactions for input */ 
2 output_data_transactions fixed bin (35), /* number of mailbox transactions for output */ 
2 input_control_transactions flxed bin (35), /* number of mailbox transactions for inbound control info */ 
2 output_control_transactions fixed bin (35), /* number of mailbox transactions for outbound control info */ 
2 cumulative_mbx_in_use fixed bin (35), /* cumulative count of number of outbound mailboxes in use */ 
2 max_mbx_in_use fixed bin, /* maximum number of mailboxes in use at any given time */ 
2 mbx_in_use_updated fixed bin (35), /* number of increments to cumulative_mbx_in_use */ 
2 mbx_unavallable fixed bin (35), /* number of times had to queue mailbox transaction because none available */ 
2 free_size fixed bin (35), /* cunulative amount of bleft_355 */ 
2 free_count fixed bin, /* number of adds to above */ 


pepe rere cr DP pi A i PP SPP: P77 S-type ensures 


*.inel dn355_data.incl.pl1 Page 2 


2 fnp_ space_restricted_output fixed bin (35), 
2 tandd_pebx fixed bin, 
2 n_pages wired fixed bin, 


/* number of times available FNP space restricted amount of output sent */ 


/* index of PCB for COLTS channel */ 
/* pages wired for loading */ 


2 config flags aligned, 


3 available bit (1) unaligned, /* veconfig says “yes" */ 

3 Lo manager_assigned bit (1) unaligned, /* We have channel assigned to us */ 

3 pad bit (34) aligned, 
2 ptx fixed bin, /* page table index, used only at bootload */ 
2 ptp pointer unaligned; /* page table for this FNP */ 


/*** The following named constants are used to lay out the 
iom page tables. Each FNP has to have its own page 
table because there is not enough room to have eight different 
bootload images of 32 K and > 64 K of tty_buf 


THE MAX TTY BUF LENGTH IS 192 K words. We could have another 16 K 
easily, and then after that it would get hard. */ 


[wie The Layout 


Page I/O address Memory address Comments 


0 0 XXXXKK invalid PTW 

1 2000 2000 write-enabled (mailbox) 

2 4000 4000 write-enabled (mailbox) 

3 6000 6000 write-enabled (mailbox) 

4 10000 as needed bootload image segment page 0 
35 110000 as needed bootload image segment page 31 
36 112000 XXKXKK invalid PTW 

63 160000 oar invalid PTW 

64 200000 ‘as needed tty_buf page 0 

127 260000 as needed tty_buf page 63 

2555 i Mveisee  “aetave tty_buf page 191 


w/ 
{wit We assume that the page table starts at all zeros. */ 


declare FIRST_BOOTLOAD PAGEX fixed bin init (4) int static options (constant); 
declare FIRST_TTY_BUF_PAGEX fixed bin init (64) int static options (constant); 


/* End include file dn355_data.incl.pl1 */ 
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let.inel.pli segment in: >ldd>include contents modified: 11/08/82 1005.8 


entry modified: 06/21/85 1917.0 


/* BEGIN INCLUDE FILE ... let.incl.pl1 */ 


/* Greated by J. Stern 7/26/78 */ 
/* Metering information added by C. Hornig, March 1980. */ 
/* Unwired saved meters added by Robert Coren, December 1980 */ 


del letp ptr; /* ptr to logical channel table */ 
del lctep ptr; /* ptr to logical channel table entry */ 
del let size fixed bin; /* size of lcte_array when allocated */ 
dcl 1 let aligned based (lctp), /* Logical channel table */ 
2 max_no_lctes fixed bin, /* maximum number of lect entries */ 
2 cur_no_letes fixed bin, /* current number of lct entries used */ 
2 lent_ptr ptr, /* ptr to logical channel name table */ 
2 queue_lock bit (36), /* lock used to serialize queueing operations */ 
2 pad (11) fixed bin, 
2 lete_array (lct_size refer (lct.max_no_letes)) like lcte; /* let entries */ 


del 1 lete aligned based (letep), /* logical channel table entry */ 
2 lock bit (36), /* channel lock */ 
2 data_base_ptr ptr unal, /* ptr to channel data base */ 
2 channel_type fixed bin (8) unal, /* identifies channel manager program */ 
2 flags unal, 
3 entry_in_use bit (1) unal, /* ON if this entry in use */ 
3 initialized bit (1) unal, /* ON if this channel initialized */ 
3 notify_reqd bit (1) unal, /* ON if must notify when unlocking this channel */ 
3 locked_for_interrupt bit (1) unal, /* ON if lock set by interrupt handler */ 
3 space_needed bit (1) unal, /* ON if this channel needs buffer space */ 
3 special_lock bit (1) unal, /* ON if lock is managed by multiplexer */ 
3 trace_force bit (1) unal, /* ON to trace based on next bit only */ 
/* OFF to XOR next bit with tty_buf.default_tracing */ 
3 trace bit (1) unal, /* ON to trace this channel */ 
3 unused bit (1) unal, 
2 physical_channel_devx fixed bin (17) unal, /* devx of physical chan from which logical chan is derived */ 
2 major_channel_info, 
3 major_channel_devx fixed bin unal, /* major channel device index */ 
3 subchannel fixed bin (17) unal, /* subchannel id (or data ptr) wrt major channel */ 
2 queuve_entries, 
3 queue_head bit (18) unal, /* ptr to first queue entry for this channel */ 
3 queue_tail bit (18) unal, /* ptr to last queue entry for this channel */ 
2 word counts, 
3 input_words fixed bin (17) unal, /* number of input words charged to this channel */ 
3 output_words fixed bin (17) unal, /* number of output words charged to this channel */ 
2 meters, 
3 in_bytes fixed bin (35), 
3 out_bytes fixed bin (35), 
3 in, 
4 calls fixed bin (35), 
* incl —— ———a let.inel.pli Page 


4 interrupts fixed bin (35), 
4 call_time fixed bin (71), 
4 interrupt_time fixed bin (71), 
3 out Like Llcte.meters.in, 
3 control like lcte.meters.in, 
2 saved_meters_ptr ptr, 
2 timer_offset bit (18) aligned, 


2 pad (3) fixed bin (35); 
del lentp ptr; 
del 1 lent aligned based (lentp), 
2 names (let.max_no letes) char (32) unal; 


dcl 1 saved_meters aligned based Like lcte.meters; 


/* END INCLUDE FILE ... let.incl.pll */ 


incl 


let.incl .pli 


pointer to unwired copy of meters saved at last dialup */ 


Head of list of timers for this channel */ 


ptr to logical channel name table */ 


logical channel name table */ 
channel names */ 


meters saved at dialup, allocated in tty_area */ 


Page 
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peb.incl.pl1l segment. in: >ldd>include contents modified: 07/08/81 1045.8 
entry modified: 06/21/85 1915.3 
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/* BEGIN INCLUDE FILE ... peb.incl.pli */ 

/* Created 08/14/78 by Robert S. Coren */ 

/* Modified 02/19/80 by Robert S. Coren to add read_ first & read_last */ 
/* Modified 12/10/80 by Robert S. Coren to add metering stuff */ 

/* Modified May 1981 by Robert S.Coren to add tandd_attached flag */ 

/* Describes physical channel blocks for FNP channels */ 


del n_pebs fixed bins 
del pcbp ptr; 


del 1 peb_array (n_pebs) based aligned like pcb; 


del 1 peb aligned based (pcbp), /* physical channel block declaration */ 
2 channel _desc unaligned, 
3 devx fixed bin (17), {* index of LCT entry */ 
3 subchan fixed bin (7) unaligned, /* logical subchannel/lsla slot # correspondence */ 
3 line_number unal, /* vegular line number */ 
4 is hsla bit (1) unaligned, /* on if hsla, off if lsla */ 
4 la_no bit (3) unaligned, /* line adapter (high or low speed) number */ 
4 slot_no blt (6) unaligned, /* physical slot or subchannel number */ 
2 write_first fixed bin (17) unaligned, /* offset of first buffer in output chain */ 
2 write_last fixed bin (17) unaligned, /* offset of last buffer in output chain */ 
2 baud_rate fixed bin (17) unaligned, /* baud rate of channel */ 
2 Line_type fixed bin (17) unaligned, /* line type */ 
2 max_buf_size fixed bin (17) unaligned, /* largest buffer to be allocated for output */ 
2 write_ent fixed bin (17) unaligned, /* number of characters in write chain */ 
2 flags unaligned, 
3 listen bit (1), /* channel is ready for dialup */ 
3 dialed bit (1), /* channel is dialed up or connected */ 
3 send_output bit (1), /* channel is ready for output */ 
3 high_speed bit (1), /* needs large send_out threshold */ 
3 syne_line bit (1), /* synchronous channel */ 
3 end_frame bit (1), /* channel is waiting for formfeed */ 
3 hndlquit bit (1), /* channel in hndlquit mode */ 
3 breakall_ enabled bit (1), /* breakall mode allowed for this channel */ 
3 output_mbx_ pending bit (1), /* A wtx mbx has been sent, but not relinquished */ 
3 copied meters ready bit (1), /* copy_meters operation has completed */ 
3 get_meters_waiting bit (1), /* waiting for get_meters operation to complete */ 
3 tandd_attached bit (1), /* this channel is in use by T & D */ 
3 padb bit (24), 
2 vead_first fixed bin (18) unsigned unaligned, /* head of read chain (while reading from FNP) */ 
2 read_last fixed bin (18) unsigned unaligned, /* tail of read chain (likewise) */ 
2 saved _meters_ptr pointer unaligned, /* pointer to (unwired) copy of meters at last dialup */ 
2 copled_meters_offset fixed bin (18) unsigned; /* offset in tty_buf of buffer meters copied to */ 
/* END INCLUDE FILE ... peb.incl.pl1 */ 
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/* BEGIN INCLUDE FILE ... teb.incl.pl1 */ 


/* Date Last Modified and Reason 


segment 


entry modified: 


Created 04/19/77 by J. Stern (from part of tty.incl.pl1) 
Modified 2/6/78 by Robert Coren to add input_msg_ size 
Modified 4/18/78 by Robert Coren to add framing_chars 
Modified 8/31/78 by J. Nicholls to add scroll mode 
Extracted 9/12/78 by J. Stern from tty_data.inel.pl1 
Modified Oct.1979 by Robert Coren to expand to 36 possible modes 

Modified 1/21/80 by Robert Coren to add no_outp, oddp, & eight_bit modes 
Modified 10/08/80 by Robert Coren to add meters for tty_read & tty_write 
Modified: 10 November 1980 by G. Palter to add can_type and explicit padding 
Modified 12/04/80 by Robert Coren to add saved copy of meters 

Modified 2/24/81 by Robert Coren to add time spent in tty_read and write 
Modified April 1981 by Robert Coren to add time last dialed up 


w/ 


del tcbp ptr; 


del 1 tcb based (tcbp) aligned, 
2 terminal_type char (32) unaligned, 
2 tables, 
3 input_mvtrp bit (18) unaligned, 
3 output_mvtrp bit (18) unaligned, 
3 input_tetrp bit (18) unaligned, 
3 output_tctrp bit (18) unaligned, 
3 specialrp bit (18) unaligned, 
3 delayrp bit (18) unaligned, 
2 default tables, 
3 df_input_mvtrp bit (18) unaligned, 
3 df_output_mvtrp bit (18) unaligned, 
3 df_input_tctrp bit (18) unaligned, 
3 df_output_tetrp bit (18) unaligned, 
3 df_specialrp bit (18) unaligned, 
3 df_delayrp bit (18) unaligned, 
2 special input_chars unaligned, 
3 erase char (1) unaligned, 
3 kill char (1) unaligned, 
2 old_type fixed bin (17) unaligned, 


2 modes unaligned, 
3 edited bit (1) unaligned, 
3 tabm bit (1) unaligned, 
3 canm bit (1) unaligned, 


3 esem bit (1) unaligned, 
ecklm bit (1) unaligned, 
3 rawim bit (1) unaligned, 


Ww 
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/* 
i* 


i* 
[* 
i/* 
/* 
/* 


i* 


{* 
|* 
{* 
i* 
/* 
/* 


/* 
{[* 
i* 


/* 
/[* 
/* 
(* 


[* 


/* 
[* 


teb.incl.pli 


>ldd>include contents modified: 


06/21/85 1915.2 


in: 


declaration of per terminal control block */ 
terminal type name */ 


rel 
rel 
rel 
rel 
rel 
rel 


current 
current 
current 
‘current 
current 
current 


input mvt table */ 
output mvt table */ 
input tet table */ 
output tet table */ 
special chars table */ 
delay table */ 


pointer to 
pointer to 
pointer to 
pointer to 
pointer to 
pointer to 


default 
default 
default 
default 
default 
default 


rel 
rel 
rel 
rel 
rel 
rel 


input mvt table */ 
output mvt table */ 
input tet table */ 
output tet table */ 
special chars table */ 
delay table */ 


pointer to 
pointer to 
pointer to 
pointer to 
pointer to 
pointer to 


erase character */ 
kill character */ 
old terminal type number */ 


modes set by order call */ 
edited output mode */ 

insert output tabs mode */ 

do canonical form conversion */ 


do input escape conversions */ 
do erase kill processing */ 
don’t convert input */ 


06/18/81 0900.8 


Page 


Le) 


& w 


ww 


3 
3 


3 


rawom bit (1) unaligned, 
redm bit (1) unaligned, 
vertsp bit (1) unaligned, 


echo_cr bit (1) unaligned, 
echo lf bit (1) unaligned, 
echo tab bit (1) unaligned, 


hndlquit bit (1) unaligned, 
full_duplex bit (1) unaligned, 
echoplex bit (1) unaligned, 


upper_case bit (1) unaligned, 
replay bit (1) unaligned, 
polite bit (1) unaligned, 


control bit (1) unaligned, 
blk_xfer bit. (1) unaligned, 
breakall bit (1) unaligned, 


scroll bit (1) unaligned, 
prefixnl bit (1) unaligned, 
wake_tbl bit (1) unaligned, 


iflow bit (1) unaligned, 
oflow bit (1) unaligned, 
no_outp bit (1) unaligned, 


eight_bit bit (1) unaligned, 
odd_parity bit (1) unaligned, 


modes pad bit (7) unaligned, 


2 id char (4) unaligned, 


i] 


colmax fixed bin (8) unaligned, 


2 linemax fixed bin (8) unaligned, 


ied 


wrt_lchar fixed bin (17) unaligned, 


2 input_msg_ size fixed bin, 


ied 


3 


framing _chars unaligned, 
3 frame_begin char (1) unaligned, 


frame_end char (1) unaligned, 


/* don’t convert output */ 
i* has red-shift function */ 
/* send real ff’s and vt’s if on, else escape them */ 


/* echo carriage returns */ 
/* echo line feeds */ 
/* echo tabs */ 


/* cr’s on quit */ 
/* xmit and receive simultaneously */ 
/* echo input characters on terminal */ 


/* map lower-case output into upper-case */ 
/* replay interrupted input */ 
/* output must start at left margin */ 


/* accept control characters */ 
/* block transfer or "frame" mode */ 
/* break on all characters */ 


{* scroll mode for crt terminals */ 
/* prefix output iwth nl when input interrupted */ 
/* input wakeups determined by wakeup table */ 


/* input flow control */ 
/* output flow control */ 


/* don’t generate output parity */ 


/* don’t strip input parity */ 
/* generate odd parity (if any) */ 


/* terminal id */ 

/* current maximum number of columns */ 

/* current maximum number of lines/frame */ 
/* char within last write block */ 


/* maximum input message size in chars */ 


/* £rame-begin character */ 
(* frame-end character */ 


2 max_output_block fixed bin (18) unsigned unaligned, /* maximum size of output block in block acknowledge */ 


2 input_suspend seq unaligned, 
3 count fixed bin (9) unsigned, 


3 


chars char (3), 


2 input_resume_seq unaligned, 
3 count fixed bin (9) unsigned, 
3 chars char (3), 


2 output_suspend_etb_seq unaligned, 


3 count fixed bin (9) unsigned, 
3 chars char (3), 


2 output_resume_ack_seq unaligned, 


*,inel 


/* sequence for input suspension */ 


/* likewise for input resumption */ 


/* sequence for output suspension or end_of_ block */ 


/* likewise for resumption or ack */ 
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3 
3 


count fixed bin (9) unsigned, 
chars char (3), 


2 flags unaligned, 


OWWwW WwW & WH & 


breakall enabled bit (1) unaligned, 
dont_count_next bit (1) unaligned, 
keyboard locking bit (1) unaligned, 
no_printer_off bit (1) unaligned, 
break _char_pending bit (1) unaligned, 
uproc_attached bit (1) unaligned, 
block_acknowledge bit (1) unaligned, 
flags_pad bit (27) unaligned, 


2 actshift bit (2) unaligned, 


2 cumulative_meters, 


3 
3 
3 
3 
3 
3 


2 saved_meters Like tcb.cunulative_meters, 


2 can_type fixed binary (9) unaligned unsigned, i* 

2 padi bit (27) unaligned, /* 

2 time_dialed fixed bin (71); i* 
/* END INCLUDE FILE ... tcb.inel.pli */ 
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read_calls fixed bin (35), 
write_calls fixed bin (35), 
vead_chars fixed bin (35), 
write_chars fixed bin (35), 
read_time fixed bin (71), 

write_time fixed bln (71), 


/% 
[* 
/* 
/* 
/* 
[* 
i* 
i* 


{* 


/* 
/* 
i* 
/* 
/* 
{* 
i* 
{* 


tty dim flag bits */ 


channel is permitted to use breakall mode */ 


next output character is escaped */ 


ON 1£ doing keybd locking for ASCIi line type */ 


reject printer off/printer_on orders */ 


break character is in preconverted buffer */ 


user process has attached device */ 
block acknowledgement output protocol */ 


tty shift, 00 none, 01 lower, 10 upper, 11 unknown */ 


continuously running meters */ 
number of calls to tty_read */ 
number of calls to tty_write */ 
after conversion */ 

before conversion */ 

total time spent in tty_read */ 
total time spent in tty_write */ 
meters saved at last dialup */ 


type of canonicalization to use on this 
to word boundary */ 
clock time of last copy_meters order */ 


channel */ 


Page 
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/* 
/* 
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segment 


entry modified: 


>Lldd>include contents modified: 01/06/85 1422.1 


06/21/85 1919.6 


in: 


BEGIN INCLUDE FILE ... tty_buf.incl.pl1 */ 

Date Last Modified and Reason 

Created 04/19/77 by J. Stern (from part of tty.incl.pll) 
Modified 
Modified 
Modified 


January 1978 by Robert Coren and Larry Johnson for variable-size buffers 
2/6/78 by Robert Coren to make circular _queue size settable 
Aug 78 by J. Nicholls to move the buffer block format to a file of its own 


and wtcb to its own plus other modification for ring 0 multiplexing, tty_buffer_block.inel.pll 
Modified 7/17/79 by B. Greenberg for echo negotiation meters. 
Modified November 1979 by C. Hornig for MCS tracing. 
Modified December 1979 by Robert Coren to add FNP channel lock meter 
Modified February 1980 by Robert Coren to remove all references to circular buffer 
Modified March 1980 by Robert Coren to reorganize metering information 
Modified December 1980 by Robert Coren to add FNP-specific events 
Modified 24 March 1982, W. Olin Sibert, to add mcs_timer support, recoverable_error_severity 
Modified November 1984 by Robert Coren to add tty_area_lock 
wf 
del ttybp ptr, 
tty_buf$ ext static, /* tty buffer segment */ 
tty_ev fixed bin int static options (constant) init (57), /* event used for wait and notify */ 
abs buf limit fixed bin (18) static options (constant) init (64), /* minimum number of words we will leave free */ 
input_bpart fixed bin (18) static options (constant) init (2), /* fraction of bleft we will allow for input */ 
output_bpart fixed bin (18) static options (constant) init (4); /* fraction of bleft we will allow for output */ 
del qblock_size fixed bin int static options (constant) Init (16); /* size in words of a delay queue block */ 
del bsizec fixed bin int static options (constant) init (60); /* number of characters in smallest buffer */ 
dcl buf_per_second fixed bin int static options (constant) init (10); /* for figuring out max. buffer size based on speed */ 
del FNP_DUMP_PATCH_EVENT fixed bin int static options (constant) init (58); 
dcl FNP_METER_EVENT fixed bin int static options (constant) init (59); 
del TTY_AREA_LOCK_EVENT bit (36) aligned int static options (constant) init ("74"b3); 
del 1 tty_buf aligned based (ttybp), /* declaration of tty buffer seg */ 
2 slock bit (36), /* per system lock */ 
2 absorig fixed bin (24), /* abs address of this seg */ 
2 borig bit (18), /* index of start of buffer area */ 
2 bleft fixed bin (18), {* words left in pool */ 
2 free bit (18), /* pointer to start of free pool */ 
2 fnp_config flags (8) bit (1) unal, /* £flag(i) ON if fnp(i) configured */ 
2 padb1 bit (28) unaligned, 
2 let_ptr ptr, /* pointer to logical channel table */ 
2 nrawread fixed bin (35), /* number of raw chars input, total */ 
2 nrawwrite fixed bin (35), /* number of raw characters output */ 
2 ninchars fixed bin (35), /* total input chars after conversion */ 
2 noutchars fixed bin (35), {* total output chars before conversion */ 
2 readblocked fixed bin (35), /* number of times go input blocked */ 
2 nblocked fixed bin (35), /* number of times process output blocked */ 
* inel tty_buf.incl.pli 
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2 minbuf fixed bin (18), /* min output buffer size */ 
2 totbuf fixed bin (35), /* divide by nblocked to get ave buffer size */ 
2 preconverted fixed bin (35), /* number of converted chars held in tty_buf */ 
2 input_restart fixed bin, /* number of times tty_read had to start over */ 
2 output_restart fixed bin, /* number of times tty write has had to start over */ 
2 output_buffer overflow fixed bin, /* number of times tty_write has run out of buffers ¥/ 
2 read_time fixed bin (71), /* total time spent in tty_read */ 
2 write _time fixed bin (71), /* total time spent in tty_write */ 
2 read_calls fixed bin (35), /* number of calls to tty_read */ 
2 write_calls fixed bin (35), /* number of calls to tty_write */ 
2 bfx fixed bin, /* used in calls to iobm */ 
2 nquits fixed bin (35), /* number of quits */ 
2 space _needad_ data, 
3 space_needed bit (1) unal, /* space_needed bit on in at least 1 lcte */ 
3 space_needed_ calls fixed bin (34) unal, /* meter of uses of this facility */ 
2 space_lock_count fixed bin (35), /* count of times tty_buf.slock locked */ 
2 space_lock_wait_count fixed bin (35), /* count of times necessary to loop to lock it */ 
2 space_lock_walt_time fixed bin (35), /* total time looped trying to lock it */ 
2 alloc calls fixed bin (35), /* total number of allocations performed in tty_buf */ 
2 free_calls fixed bin (35), /* total number of freeings in tty_buf */ 
2 alloc_time fixed bin (35), /* time spent masked in tty_space_man$get entries */ 
2 free_time fixed bin (35), /* time spent masked in tty_space_man$free entries */ 
2 total_alloc_steps fixed bin (35), {/* number of steps thru free chain while doing above */ 
2 alloc failures fixed bin (35), /* number of unsuccessful attempts to allocate space */ 
2 cumulative_input_space fixed bin (71), /* cumulative amount of space allocated for input */ 
2 cumulative_output_space fixed bin (71), /* cumulative amount of space allocated for output */ 
2 cumulative_control space fixed bin (71), /* cumulative amount of space allocated by tty_space_man$get_space */ 
2 input_space_updates fixed bin (35), /* number of increments to cumulative_input_space */ 
2 output_space_updates fixed bin (35), /* number of increments to cumulative_output_space */ 
2 control_space_updates fixed bin (35), /* number of increments to cumulative_control_space */ 
2 minimum_free_space fixed bin (18), /* smallest amount of free space ever available */ 
2 current_input space fixed bin (18), /* amount of space currently allocated for input */ 
2 current_output_space fixed bin (18), /* amount of space currently allocated for output */ 
2 current_control_space flxed bin (18), /* amount of space currently allocated by get_space */ 
2 tty_lock calls fixed bin (35), /* number of calls to tty_lock$lock entries */ 
2 found_channel locked fixed bin (35), /* number of times tty_lock found channel already locked */ 
2 max_wait_time fixed bin (35), /* longest time waited for any channel lock */ 
2 total_wait_time fixed bin (71), /* total amount of time spent waiting for channel locks */ 
2 echo_neg_time fixed bin (71), /* cumulative time spent doing echo negotiation */ 
2 echo _neg_ interrupts fixed bin (35), /* Echo-negotiated shipments */ 
2 echo_neg_r0_chars fixed bin (35), /* Chars echoed by ring 0 */ 
2 echo_neg_mux_chars fixed bin (35), /* Chars echoed by mux */ 
2 echo_neg_sndopt_restarts fixed bin (35), (* Echo reinits */ 
2 echo_neg_mux_nonecho fixed bin (35), 
2 echo_neg_ entries fixed bin (35), /* Entries into negotiate */ 
2 echo_neg_mux_inhibit bit (1) aligned, /* For testing */ 
2 n_queued_interrupts fixed bin (35), /* number of interrupts queued by tty_lock */ 
2 trace unaligned, /* tracing information */ 
3 flags, 
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enable bit, 
default_mode bit, 
read bit, 

write bit, 

data bit, 

control bit, 

modes bit, 
interrupt bit, 
init bit, 

start bit, 
shutdown bit, 
space_man bit, 
pad_flags bit (6), 
data_offset bit (18), 


OPrrpr FF PFPFrrrrrres 


recoverable _error_severity fixed bin, 


timer_lock bit (36) aligned, 
next_timer_offset bit (18) aligned, 
timer_count fixed bin, 
timer_process bit (36) aligned, 


timer_ev_chn fixed bin (71), 
timer_lock_wait_time fixed bin (71), 


timer_lock count fixed bin (35), 
timer_lock_wait_count fixed bin (35), 
timer_call_time fixed bin (71), 


timer_polling time fixed bin (71), 
timer_set_calls fixed bin (35), 
timer_reset_calls fixed bin (35), 
timer_change calls fixed bin (35), 
timer_poll calls fixed bin (35), 
timer_error_calls fixed bin (35), 
timer_duplicate_pollings fixed bin (35), 
tty_area_lock Like hc_fast_lock, 

pad2 (13) fixed bin (35), 


free_space fixed bin; 


i* 
/* 
{* 
i* 
/* 
/* 
(* 
/* 
/* 
(* 
{* 


/* 
/* 


{* 
[* 
[* 
{* 


i* 
{* 


{* 
{* 
i* 


i* 
i* 
i* 
/* 
i* 
i* 
i{* 


/* 


/* 


/* global tracing control */ 
whether to trace channels by default */ 
read */ 
write */ 
buffers on reads and writes */ 
control, priv_control, and hpriv_control */ 
(get set check) _modes */ 
interrupt, interrupt_later */ 
init_multiplexer, terminate_multiplexer */ 
start, stop */ 
shutdown */ 
tty_space_man§* */ 


offset of tracing data */ 
Syserr severity for recoverable MCS errors */ 


Lock owned by mes_timer */ 

Offset of next timer to come due */ 
Number of timers outstanding */ 
Who is doing timers? */ 


How get get him */ 
CPU time spent spinning on timer lock */ , 


Number of times timer lock locked */ 
Number of times imer lock waited on */ 
CPU time spent in call side timer operations */ 


CPU time spent polling (including channel_manager) */ 
Number of calls to mes_timerSset, set_wired */ 
Number of calls to mes_timerSreset, reset_wired */ 


Number of calls to mcs_timer$change, change_wired */ 
Number of calls to mes_timerSpoll */ 

Number of mcs_timer calls ending with recoverable errors */ 
Number of timer polling found in progress on other CPU */ 


to prevent contention in allocating/freeing in tty_area */ 


start of free space region */ 


4include he_fast_lock; 


/* END INCLUDE FILE ... tty_buf.incl.pl1 */ 
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/* BEGIN INCLUDE FILE ... tty_buffer_block.incl.pli */ 


[* 

Separated from tty_buf.incl.pl1l aug 78 by J. Nicholls 

Modified May 1979 by Larry Johnson to add max_buffer_tally array and to use unsigned variables. 
*/ 


del blockp ptr; {* pointer which block entry is based on */ 
del free _blockp ptr; /* pointer to head of free space chain */ 
dcl 1 free_block aligned based (free _blockp), {* format of start of free block */ 
2 next bit (18), (* foward pointer to next free block */ 
2 size fixed bin; /* number of words in this block */ 
del 1 buffer based (blockp) aligned, {* buffer definition */ 
2 next fixed bin (18) unal uns, /* addr of next buffer */ 
2 flags unaligned, 
3 end_of_page bit (1) unaligned, /* buffer contains end of page */ 
3 converted bit (1) unaligned, /* buffer contains converted input */ 
3 break bit (1) unaligned, (/* buffer contains break character */ 
3 mark bit (1) unaligned, /* buffer contains first character after "mark" */ 
3 pad bit (2) unaligned, 
2 size_code fixed bin (3) unal uns, /* (nwords/16) - 1 */ 
2 tally fixed bin (9) unal uns, /* number of characters in buffer */ 
2 chars (0:59) char (1) unaligned; /* room for 60 data characters */ 


/* the following array, if indexed by buffer.size_code will give maximum number of characters permitted in that buffer */ 
del max_buffer_tally (0:7) fixed bin int static options (constant) init (60, 124, 188, 252, 316, 380, 444, 508); 


/* END INCLUDE FILE ... tty_buffer_block.inel.pll */ 
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/* BEGIN INCLUDE FILE ... wtcb.incl.pl1 */ 


[x 
Moved from tty_buf.incl.pl1i Aug 78 by J. Nicholls plus changes for ring 0 demultiplexing 
Error code added Nov. 1982 by Robert Coren 
Modified December: 1984 by Robert Coren to invent "more_flags" structure and 
its first flag, line_status_ disabled 


*/ 

dcl wtcbp ptr; /* pointer to head of wtcb */ 

del 1 wteb based (wtcbp) aligned, {* wired terminal control block */ 
2 hevent fixed bin (71) aligned, /* event channel for hangup/dialup signal */ 
2 event fixed bin (71) aligned, /* users event channel, for uproc */ 
2 Lline_status bit (72) aligned, /* actual Line status sent by fnp */ 
2 teb_ptr ptr unal, /* pointer to tcb */ 
2 padl fixed bin (35), /* formerly time dialedup */ 
2 hproc bit (36) aligned, /* boss processid */ 
2 uproc bit (36) aligned, i* tty user processid */ 
2 baud_rate fixed bin (18) unal uns, /* baud rate of this line */ 
2 line_type fixed bin (18) unal uns, /* Line type for line protocol */ 


2 flags unaligned, 


3 listen bit (1) unaligned, /* if on, listen for dialups */ 

3 dialed bit (1) unaligned, /* if on, Line is dialed up */ 

3 send_output bit (1) unaligned, /* on if DN355 requested more output */ 

3 qenable bit (1) unaligned, /* Lf on, signal quits */ 

3 qflag bit (1) unaligned, /* on after quit, causes writes to be ignored */ 
3 end_frame bit (1) unaligned, /* write chain fills ards frame */ 

3 notify_reqd bit (1) unaligned, /* if on, do notify after unlocking lock */ 

3 work_reqd bit (1) unaligned, /* 1£ on, call dn355 before returning */ 

3 dialing bit (1) unaligned, {* 1£ on, 355 is dialing a phone number */ 

3 dial_status_valid bit (1) unaligned, /* 1£ on, dial_status_code is valid */ 

3 input_avallable bit (1) unaligned, /* input for this device is waiting in wired space */ 
3 tceb_initialized bit (1) unaligned, /* if on, tcb has been initialized */ 

3 wflag bit (1) unaligned, /* process blocked on output */ 

3 rflag bit (1) unaligned, /* process blocked on input */ 

3 wru bit (1) unaligned, {* veading answerback */ 

3 hndlquit bit (1) unaligned, /* on if in hndlquit mode */ 

3 count_lines bit (1) unaligned, /* on L£ teb.linemax > 0 */ 

3 line_status_present bit (1) unaligned, /* fnp has sent line status */ 
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3 sync_line bit (1) unaligned, 
3 breakall bit (1) unaligned, 
scroll bit (1) unaligned, 


wo 


w 


negotiating echo bit (1) unaligned, 
3 wake tbl bit (1) unaligned, 
3 allow_wakeup bit (1) unaligned, 


3 receive_mode_device bit (1) unaligned, 
3 mark_set bit (1) unal, 
3 masked bit (1) unal, 


dial_status_code fixed bin (8) unaligned, 


fblock fixed bin (17) unaligned, 
Lblock fixed bin (17) unaligned, 


fchar fixed bin (9) unsigned unaligned, 

actline fixed bin (9) unsigned unaligned, 
actcol fixed bin (9) unsigned unaligned, 
nramsgs fixed bin (9) unsigned unaligned, 


write first fixed bin (17) unaligned, 
write last fixed bin (17) unaligned, 
write _cnt fixed bin (17) unaligned, 
white_col fixed bin (17) unaligned, 


max_buf_ size fixed bin (9) unal uns, 
buffer_pad fixed bin (9) unal uns, 
devx fixed bin (17) unaligned, 

echdp bit (18) unaligned, 

waketp bit (18) unaligned, 
prompt_len fixed bin (8) unaligned, 
prompt char (3) unaligned, 
Line_delimiter char (1) unal, 

more flags unaligned, 

3 line_status_ disabled bit (1) unaligned, 
3 pad bit (26) unal, 

error_code fixed bin (35), 

pad2 bit (36); 


/* Ends on doublewoir:d boundary */ 


/* END INCLUDE FILE .. 
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[* 
i* 
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/* 
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/* 
i* 
/* 
/* 


/* 
/* 
{* 
/* 


i* 
|* 
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/* 
{* 
i* 
{* 
{* 
{* 
{* 


{* 


wtcb.incl.pli 


channel is synchronous line type */ 
channel is in breakall mode */ 
channel is in scroll mode */ 


ring zero to echo chars. */ 
on if in wake_tbl mode */ 
on to allow input wakeup in wake_tbl mode */ 


device must be told to enter receive mode */ 
write_with_mark call outstanding */ 
channel masked by FNP */ 


code returned by 355 after dialing a phone number */ 


oldest read pointer, block */ 
newest read block */ 


first block char index */ 

line number of current line */ 

tty column position */ 

current number of read-ahead msgs */ 


first write block */ 

last write block */ 

count of chars in write chain */ 

column position resulting from trailing white space */ 


maximum-size buffer to be allocated for this channel */ 
amount of pad to be left in output buffers */ 

index into lect of channel’s entry */ 

echo negotiation data ptr */ 

wakeup table offset */ 

number of chars in prompt string */ 

text of prompt message */ 

line delimiter for tty_read parse */ 

in addition to flags (above) */ 

"1"b => don’t relay line status interrupts */ 


error code returned by channel_manager to tty_interrupt */ 
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